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PREFACE 


The system which is the subject of this documentation was 
designed originally for execution on the Univac 1108/1110 com- 
puter at the Laboratory for Applications of Remote Sensing, 

Purdue University. This volume II documented the conversion in 
1978 of the EOD-LARSYS software for execution on the IBM 370/148. 
In 1979, the IBM 370/148 -?as replaced by the IBM 3031 computer, 
which is thoroughly compatible with the software as altered for 
execution on the IBM 370/148. Thus, no conversion of software is 
required for this system to be operable on the IBM 3031 computer. 
This revision primarily documents enhancements and additions to 
the system. 





preceding page blank not FlLryi'”’^ 


V 


CONTENTS 


Section 

1. INTRODUCTION 

2. GENERAL DESCRIPTION AND OPERATION 2-1 

2.1 DESCRIPTION 2-1 

2.2 OPERATION 2-10 

2.2.1 TO START; LOG ON TO THE SYSTEM 2-11 

2.2.2 TO STOP: LOG OPE OP THE SYSTEM 2-12 

2.2.2 CARDS OR CARD IMAGES 2-13 

2.2.4 USING THE EDITOR TO CREATE, MODIFY, 

AND ERASE FILES . 2-14 

2.2.5 TO RUN A PROGRAM 2-15 

2.2.6 NOTES ON PROCEDURES FOR MINISCAN 2-16 

2.2.7 TROUBLESHOOTING 2-18 

3. INPUT 3-1 

3.1 IMAGE TAPES . 3-1 

3 . 2 CARDS AND CARD IMAGES 3-2 

3.2.1 PROCESSOR CARDS 3-2 

3.2.2 CONTROL CARDS 3-3 

3.2.3 CLASS, SUBCLASS, AND FIELD DEFINITIONS.... 3-4 

3.2.4 SPECIAL SYSTEM FILES j-9 

4. PILES 4-1 

4.1 STATISTICS FILE (SAVTAP, UNIT 20) 4-1 

4.2 B-MATRIX FILE (BMFILE, UNIT 10) ... 4-3 

4.3 ONE-DIMENSIONAL HISTOGRAM PILE 

(HiSFIL, "UNIT 13)'. . . ♦ 4-3 


VXi 




section Page 

4.4 CLASSIFICATION MAP FILE (MAPTAP> UNIT 2) 4-3 

4.5 N-DIMENSIQNAL HISTOGRAM FILE (NHSTON, UNIT 4) 4-3 

4.6 TRANSFORMED STATISTICS FILE (SAVTAP, UNIT 20) 4-4 

4.7 DOT DATA FILE (DOTUNT, UNIT 19) 4-4 

5. OUTPUT.. 5-1 

5.1 CLUSTER MAP FILE (MAPUNT» UNIT 16) 5-1 

5.2 SCATTER PLOT DATA FILE (SCTRUN, UNIT 12) 5-2 

5.3 TRANSFORMED DATA FILE (TRFORM, UNIT 14) 5-2 

5.4 MERGED MSS DATA FILE (DATAPE, UNIT 11) 5-2 

5.5 LACIE-FORMATTED DOT FILES (GTRWU, UNIT 23) 5-2 

6. ONE-DIMENSIONAL HISTOGRAM PROCESSOR — HIST 6-1 

6.1 INPUT FILES 6-1 

6.2 OUTPUT FILES .. .’ 6-1 

6.3 SCRATCH FILES 6-1 

6.4 CARD INPUT 6-2 

6.4.1 PROCESSOR CARD 6-2 

6.4.2 SPECIAL SYSTEM PILES 6-2 

6.4.3 CONTROL CARDS 6-2 

6.4.4 FIELD DEFINITIONS 6-2 

6.5 CARD OUTPUT 6-3 

6.6 RESTRICTIONS 6-3 

6.7 DIAGNOSTIC MESSAGES 6-3 

7. GRAY MAP PROCESSOR _ GRAYMAP 7-1 

7.1 INPUT FILES 7-1 

7.2 OUTPUT FILES 7-2 


viii 



Section Page 

7.3 SCRATCH PILES .... 7-2 

7.4 CARD INPUT 7-2 

7.4.1 PROCESSOR CARD 7-2 

7.4.2 SPECIAL SYSTEM PILES 7-2 

7.4.3 CONTROL CARDS 7-2 

7.4.4 FIELD DEFINITIONS 7-3 

7.5 CARD OUTPUT 7-3 

7 . 6 RESTRICTIONS 7-3 

7 .7 DIAGNOSTIC MESSAGES 7-3 

8 . STATISTICS PROCESSOR — STAT 8-1 

8.1 INPUT FILES 8-3 

8.2 OUTPUT FILES 8-3 

8.3 SCRATCH FILES 8-4 

8.4 CARD INPUT 8-4 

8.4.1 PROCESSOR CARD 8-4 

8.4.2 SPECIAL SYSTEM PILES..... 8-5 

8.4.3 CONTROL CARDS 8-5 

8.4.4 CLASS, SUBCLASS, AND FIELD DEFINITIONS 8-5 

8.5 CARD OUTPUT 8-7 

8.6 RESTRICTIONS 8-7 

8.7 DIAGNOSTIC MESSAGES 8-8 

9. ITERATIVE SELF-ORGANISING CLUSTERING SYSTEM 

PROCESSOR — ISOCLS 9-1 

9.1 PROCEDURES 9-3 

9.1.1 NOTATION 9-3 

ix 


Section 


9.1.2 ESTABLISHING THRESHOLD VALUES 

9.1.3 ITERATIVE PROCEDURE.... 

9.1.4 CHAINING 

9 . 2 INPUT FILES 

9.3 OUTPUT FILES 

9 . 4 SCRATCH FILES 

9.5 CARD INPUT 

9.5.1 PROCESSOR CARD 

9.5.2 SYSTEM CARD FILES 

9.5.3 CONTROL CARDS 

9.5.4 CLASS AND FIELD DEFINITIONS.. 

9 . 6 CARD OUTPUT . 

9.7 RESTRICTIONS 

9.8 DIAGNOSTIC MESSAGES 

10. FEATURE SELECTION PROCESSOR _ SELECT 

10.1 INPUT FILES 

10.2 OUTPUT FILES 

10.3 SCRATCH FILES 

10.4 CARD INPUT 

10.4.1 PROCESSOR CARD 

10.4.2 SYSTEM CARD PILES 

10.4.3 CONTROL CARDS 

10.4.4 FIELD DEFINITIONS 

10.5 CARD OUTPUT 

10.6 RESTRICTIONS 



Section Page 

10.7 DIAGNOSTIC MESSAGES 10-5 

11. CLASSIFICATION PROCESSOR — CLASSIFY 11-1 

11.1 PROCEDURES 11-1 

11 1.1 STANDARD M-CLASS CLASSIFICATION 11-1 

11.1.2 SUM-OF-NORMAL-DENSITIES CLASSIFICATION 11-3 

11.1.3 PROCEDURE 1 11-4 

11.2 INPUT FILES 11-5 

11.3 OUTPUT FILES 11-5 

11.4 SCRATCH FILES 11-5 

11.5 CARD INPUT 11-5 

11.5.1 PROCESSOR CARD 11-5 

11.5.2 SPECIAL SYSTEM PILES 11-5 

11.5.3 CONTROL CARDS . 11-6 

11.5.4 FIELD DEFINITIONS ...... 11-6 

11.6 CA RD OUTPUT . 11-6 

11.7 RESTRICTIONS 11-7 

11.8 DIAGNOSTIC MESSAGES 11-8 

12. DISPLAY OF CLASSIFICATION RESULTS 

PROCESSOR _ DISPLAY 12-1 

12.1 INPUT FILES 12-5 

12.2 OUTPUT FILES 12-5 

12.3 SCRATCH FILES . 12-6 

12.4 CARD INPUT 12-6 

12.4.1 PROCESSOR CARD 12-6 

12.4.2 SPECIAL SYSTEM FILES 12-6 


Section Page 

X2 .4 .3 CONTROL CARDS 12-6 

12.4.4 CLASS, SUBCLASS, AND FIELD DEFINITIONS 12-6 

12.5 CARD OUTPUT 12-9 

12.6 RESTRICTIONS 12-9 

12.7 DIAGNOSTIC MESSAGES 12-9 

13. DATA TRANSFORMATION PROCESSOR — DATATR 13-1 

13.1 PROCEDURES 13-1 

13.1.1 HISTOGRAM (DEFAULT) METHOD 13-2 

13.1.2 STATISTICAL METHOD. 13-3 

13.1.3 USER-INPUT METHOD 13-4 

13.2 INPUT FILES 13-4 

13.3 OUTPUT FILES 13-4 

13.4 SCRATCH FILES 13-5 

13.5 CARD INPUT 13-5 

13.5.1 PROCESSOR CARD ,.... 13-5 

13.5.2 SPECIAL SYSTEM FILES 13-5 

13.5.3 CONTROL CARDS 13-5 

13.5.4 FIELD DEFINITIONS 13-5 

13.6 CARD OUTPUT 13-6 

13.7 RESTRICTIONS l‘3-6 

13.8 DIAGNOSTIC MESSAGES 13-7 

14. STATISTICS TRANSFORMATION PROCESSOR — TRSTAT 14-1 

14.1 INPUT FILES 14-1 

14.2 OUTPUT FILES 14-2 

14.3 SCRATCH FILES 14-2 

xii 


Section Page 

14.4 CARD INPUT 14-2 

14.4.1 PROCESSOR CARD 14-2 

14.4.2 A-MATRIX FILE 14-2 

14.4.3 CONTROL CARDS. 14-3 

14.4.4 FIELD DEFINITIONS 14-3 

14.5 CARD OUTPUT 14-3 

14.6 RESTRICTIONS 14-4 

14.7 DIAGNOSTIC MESSAGES . . . 14-4 

15. N-DIMENSIONAL HISTOGRAM PROCESSOR — NDHIST 15-1 

15.1 PROCEDURES 15-1 

15.2 INPUT FILES 15-2 

15.3 OUTPUT FILES . 15-3 

15.4 SCRATCH FILES 15-3 

15.5 CARD INPUT 15-3 

15.5.1 PROCESSOR CARD 15-3 

15.5.2 SYSTEM CARD FILES 15-3 

15.5.3 CONTROL CARDS 15-3 

15.5.4 FIELD DEFINITIONS 15-4 

15.6 CARD OUTPUT 15-5 

15.7 RESTRICTIONS . 15-5 

15.8 DIAGNOSTIC MESSAGES 15-6 

16. SCATTER PLOT PROCESSOR — SCTRPL 16-1 

16.1 INPUT FILES 16-4 

16.2 OUTPUT FILES 16-4 

16.3 SCRATCH PILES . 16-4 


xiii 


Section 

16.4 CARD INPUT ..*. 16-4 

16.4.1 PROCESSOR CARD. ... 16-4 

16.4.2 SYSTEM CARD PILES 16-5 

16.4.3 CONTROL CARDS. 16-5 

16.4.4 FIELD DEFINITIONS. 16-5 

16.5 CARD OUTPUT 16-5 

16.6 RESTRICTIONS 16-5 

16.7 DIAGNOSTIC MESSAGES 16-6 

17. DOT DATA PROCESSOR — DOTDATA 17-1 

17.1 PROCEDURES . . . . 17-1 

l’?*^ INPUT FILES 17-1 

17.3 OUTPUT FILES 17-2 

— m m 

17.4 SCRATCH FILES . . 17-2 

17.5 CARD INP UT 17-2 

I I II ■ I I Ik 

17.5.1 PROCESSOR CARD 17-2 

17.5.2 SYSTEM CARD FILES 17-2 

17.5.3 CONTROL CARDS 17-2 

17.5.4 FIELD DEFINITIONS 17-2 

17.6 CARD OUTPUT 17-5 

17 -.7 RESTRICTIONS 17-5 

17.8 DIAGNOSTIC MESSAGES 17-5 

18. CLUSTER LABELING PROCESSOR — LABEL 18-1 

18.1 PROCEDURES 18-1 

18.2 INPUT FILES 18-3 

18.3 OUTPUT FILES 18-3 

. xiv 


Seetion Pago 

18.4 SCRA'^Ml PILES 18"4 

18 «S CARD INPUT . ..................................... 18**4 

13 .5 .1 PROCESSOR CARD. ............................... 18“4 

18.5.2 SYSTEM CARD PILES 18-4 

18 . 5 .3 CONTROL CARDS , 18-4 

18.5.4 FIELD DEFINITIONS. 18-4 

18.6 CARD OUTPUT 18-5 

18.7 RESTRICTIONS . 18-5 

18.8 DIAGNOSTIC MESSAGES 18-5 

19. INCORPORATION OP RECENTLY DEVELOPED AND FUTURE 

PROCESSORS 19-1 

20. DATA MERGE PROCESSOR — DAMRG 20-1 

20.1 DESCRIPTION 20-1 

20.2 INPUT/OUTPOT 20-2 

21. GROUND TRUTH DOT LABELING PROCESSOR — GTDDM 21-1 

21.1 DESCRIPTION 21-1 

21.2 INPUT/OUTPUT 21-1 

22. GROUND TRUTH DATA CONVERSION PROCESSOR — GTTCN 22-1 

22.1 DESCRIPTION 22-1 

22.2 INPUT/OUTPUT 22-2 

23. EFFICIENT CLUSTERING PROCESSOR TESTS? 23-1 

24. SYSTEM RESTRICTIONS 24-1 


Appendix Page 

A. r.’^r/RENCES A-1 

B. BARSYS III FOPmT FOR AN MSS DATA TAPE B-1 

C. UNIVERSAL FORMAT FOR AN MSS DATA TAPE... C-1 

D. MAPTAP FILE FORMAT.. D-1 

E. NHSTUN FILE FORMAT E-1 

F . DOTUNT FILE FORMAT F”1 

G. DESCRIPTION OP CLUSTER IMAGE DISPLAY WITH 

COLOR KEYS G-1 

H. SCTRUN FILE FORMAT H-1 

I . DIAGNOSTIC MESSAGES I-I 

J. SAMPLE PROCEDURE 1 EXECUTION OF EOD-LARSYS J-1 

K. LAC IE- FORMATTED DOT PILE FORMAT K-1 


xvi 


TABLES 


Table Page 

3-1 ANCILLARY CARDS FOR ALL PROCESSORS 3-20 

3- 2 FIELDS IN THE PROCESSORS OF EOD-LARSYS 3-21 

4- 1 DEFAULT FILE ASSIGNMENTS 4-5 

5- 1 OVERVIEW OF EOD-LARSYS INPUT/OUTPUT.. 5-3 

0-1 CONTROL CARDS FOR HIST 6-4 

7- 1 CONTROL CARDS FOR GRAYMAP 7-4 

8- 1 CONTROL CARDS FOR STAT 8-9 

9- 1 CONTROL CARDS FOR ISOCLS 9-15 

10- 1 CONTROL CARDS EOR SELECT.... 10-6 

11- 1 CONTROL CARDS FOR CLASSIFY 11-9 

* 

12- 1 CONTROL CARDS FOR DISPLAY 12-10 

13- 1 CONTROL CARDS FOR DATATR 13-8 

14- 1 CONTROL CARDS FOR TRSTAT 14-5 

15- 1 CONTROL CARDS FOR NDHIST 15-7 

16- 1 CONTROL CARDS FOR SCTRPL 16-7 

17- 1 CONTROL CARDS FOR DOTDATA 17-6 

18- 1 CONTROL CARDS FOR LABEL 18-6 

20- 1 CONTROL CARDS FOR DAMRG. . 20-3 

21- 1 CONTROL CARDS FOR GTDDM 21-2 

22- 1 CONTROL CARDS FOR GTTCN 22-3 


xvii 


FIGURES 


Figure ‘ Page 

2-1 Major processing paths in EOD-l»ARSYS 2-19 

2-2 EOD-LARSYS queries and responses 2-21 

7- 1 Functional diagram showing interaction of the 

HIST and GRAYMAP processors ............ 7-6 

4 

8- 1 Functional flow chart for the STAT processor 8-17 

9- 1 Functional flow chart for the ISOCLS processor 9-23 

9-2 Odd-shaped clusters 

(a) The boomerang-shaped cluster 9-25 

(b) The donut-shaped cluster 9-25 

9-3 Breaking up of the clusters into subclusters 

(a) Subclustering of the boomerang-shaped 

cluster S .:5 

(b) Subclustering of the donut-shaped 

cluster 9-25 

9-4 Example of chaining 

(a) Cluster structure 9-26 

(b) Intercluster distance table 9-26 

9-5 Example in which chained subclusters can 

judiciously be combined into one composite 

cluster. 9-27 

10- 1 Functional flow chart for the SELECT processor 10-14 

11- 1 Functional flow chart for the CLASSIFY 

processor 11-16 

12- 1 Functional flow chart for the DISPLAY processor.... 12-17 

13- 1 Functional flow chart for the DATATR processor 13-14 

14- 1 Functional flow chart for the TRSTAT processor 14-8 

15- 1 Functional flow chart for the NDHIST processor 15-10 

16- 1 Functional flow chart for the SCTRPL processor 16-12 


FACE BIAMK 


xix 


Figure Page 

17- 1 Functional flow chart for the DOTDATA processor.... 17-8 

18- 1 Functional flow chart for the LABEL processor...... 18-12 

20*"! Functional flow chart for the DAMRG processor 20-5 

21- 1 Functional flow chart for the GTDDM processor...... 21-5 

22- 1 Functional flow chart for the GTTCN processor 22-5 

K-1 Dots in LACIE Procedure 1 K-3 


XX 


1 . INTRODUCTION 


Foe several years, the Earth Observations Division (EOD) of the 
National Aeronautics and Space Administration (NASA) Lyndon B. 
Johnson Space Center (JSC) has s’!i,-p'n'ted research for the 
development of techniques to be ’ in processing remotely 
sensed imagery data obtained from the multispectral scanner (MSS) 
placed aboard various aircraft and satellites. One of the 
earliest operational computer systems to use pattern recognition 
techniques in the analysis of these data was developed at Purdue 
University’s Laboratory for Applications of Remote Sensing (LARS) . 
The earliest version of the LARS system (LARSYS) was converted in 
1970 to a batch program for execution on the Univac 1108 EXEC 2 
system at NASA/JSC. 

The computer system described in this document originated from 
this early version of LARSYS. However, since 1970, personnel of 
the Earth Observations Division, Lockheed Electronics Company, 
Inc., now Lockheed Engineering and Management Services Company, 
Inc, (LOCKHEED), and other EOD support contractors have made many 
modifications and improvements to the Univac 1108 version of the 
LARSYS? thus, new techniques have been developed and programmed 
to perform additional functions in the interpretation of the 
data . 

Although the basic structure of the system remains the same, a 
large portion of it has been reprogrammed. Modifications to 
existing techniques and the addition of new techniques have 
expanded the capabilities of the system. The current version is 
called EOD version of the LARSYS (EOD-LARSYS) . In 1977, the 
software was converted from Univac 1108 Fortran to IBM Fortran IV 
for execution on the IBM 370/148 computer at the LARS. The 
EOD-LARSYS is now operational on the IBM 3031 computer located at 
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LARS , Purdue University, West Lafayette, Indiana . It may be 
accessed both on and off the JSC site by remote terminal. 

The purposes of this document are to define the capabilities and 
limitations of the system and to provide the user with the infor- 
mation needed to execute the program and obtain the output 
desired. It is assumed throughout the document that the user is 
familiar with the terminology and the pattern recognition tech- 
niques involved. No attempt is made to assist the user in the 
analysis of data output by the system. 

This EOD-LARSYS User Guide is being issued in four volumes : 

Volume I —System Overview (JSC-13821; LEC-12563, Revision A), 
May 1980 

volume II —User Reference Manual (JSC-13821? LEC-12564, 

Revision A), June 1980 (this document) 

Volume HI — As-Built Documentation (jSC-13821? LEC-12565, 
Revision A), April 1980 

Volume IV —Program Listings (JSC-13821; LEC-12566, 

Revision A) , November 1979 
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2. GENERAL DESCRIPTION AND OPERATION 


2.1 DESCRIPTION 

The EOD-LARSYS is a processing program operational on the 
IBM 3031 system at Purdue University. The system is composed of 
a system monitor and a set of processors, each of which performs 
a specific function in the analysis of MSS imagery data. Linkage 
between processors is accomplished by the use of files in the 
computer; by files on disk or tape; or, less commonly, by card 
decks. The execution of a particular batch job may begin or end 
with any processor, provided the appropriate files are furnished. 

Two pattern recognition classification schemes are provided by 
the system. One, the supervised classification algorithm known 
as the maximum likelihood classifier, is embodied in the CLASSIFY 
processor (ref. 1).* The other, an unsupervised classification 
or clustering algorithm, is embodied in the Iterative Self- 
Organizing Clustering System (ISOCLS) processor (ref. 2). 

ISOCLS, along with other processors, may be used to "train" the 
maximum likelihood classifier or to display the results of clas- 
sification. TESTSP is provided as a more efficient version of 
ISOCLS (in terms of disk space required). 

Having obtained an MSS image data tape (DATAPE) in one of the 
allowable formats (see section 3.1), the data analyst must train 
the classifier. The maximum likelihood classification algorithm 
is based on the assumption that the samples within a given class 
are distributed according to a multivariate normal probability 
density function. Such a distribution is specified completely in 
terms of a mean vector and a covariance matrix, which must be 
computed from known samples of the class being represented. This 
implies that the data analyst must have some prior knowledge 

^References are given in appendix A, 
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(i.e., ground-verified information) of specific areas within the 
MSS image . using this ground truth, the analyst must identify 
training samples for computation of statistics. The histogram 
(HIST) and gray map (GRAXMAP) processors may be used to aid the 
analyst . 

The HIST processor provides a histogram of data values from the 
MSS image for use by the GRAYMAP processor. HIST may also be 
used independently to provide the analyst with information on the 
distribution of data values within specific user-defined blocks 
(or fields) of the image. The mean, standard deviation, and 
range of data within each user-defined field are standard outputs 
from the HIST processor for each requested channel . Histogram 
plots may be obtained optionally. With the histogram informa- 
tion, a file (HISPID is written automatically for the GRAYMAP 
processor . 

The GRAYMAP processor provides the analyst with a pictorial gray- 
scale map of any channel of the MSS image for use in obtaining 
training field coordinates. The map is labeled by sample and 
scan-line numbers. From this map, the analyst may locate the 
fields within the image for which he or she has ground truth. 
Having identified the fields, the analyst must note the 
coordinates (sample and scan-line numbers at each vertex) to 
define the fields for the statistics (STAT) or ISOCLS processor. 

Alternatively, the analyst may proceed using Procedure 1 method- 
ology. Using an ERIPS* tape as input to the DOTDATA processor, 
the analyst writes a dot data file. A dot data file contains 
both type 1 and type 2 dots. Type 1 dots are used both as start- 
ing vectors for the clustering processor (ISOCLS) and as labeling 


^Earth Resources Interactive Processing System. 
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vectors for the labeling processor (LABEL) . Type 2 dots are used 
as a bias correction factor in computing the classification 
results output by the DISPLAY processor. 

The coordinates for training fields may be input to either the 
STAT or the ISOCLS processor for computation of statistics for 
the classifier. The dot data file is input to ISOCLS to compute 
.statistics. Both processors save the statistics and training 
field or dot information on a file (SAVTAP, section 4.1) for use 
in other processors . 

In using the STAT processor, the user must group training fields 
into statistically similar subclasses. Subclasses may be grouped 
further into classes. For example, three statistically similar 
subclasses of spring wheat, winter wheat, and harvested wheat may 
be grouped into one wheat class . Statistics for each subclass 
are maintained on the SAVTAP file, along with the class grouping. 
Class groupings are maintained simply for convenience in defining 
categories in the CLASSIFY processor and for performance reports 
by the DISPLAY processor. The analyst may obtain the following 
output for each training field and/or subclass. 

• Mean vector 

• Covariance matrix 

« Correlation matrix (among channels) 

• Histogram plots 

• Spectral plots 

In using the ISOCLS processor with training classes, the user 
must group the training fields into classes. The clustering 
process breaks the class data into statistically similar sub- 
classes (clusters) . Subclasses are' given names by taking the 
first two characters of the class name and two digits indicating 
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the number of the subclass within the class. Again, the statis- 
tics for each subclass are saved on the SAVTAP file for use in 
other processors. ISOCLS is an iterative self-organizing clus- 
tering procedure which uses the measure of absolute (L]_) distance 
from a picture element (pixel) to the cluster center to determine 
the similarity of pixels. At each iteration the user may obtain 
a cluster summary and map. Optionally, a cluster image data file 
(MAPUNT) may be output in either LARSYS 11/111 or Universal for- 
mat (appendixes B and C, respectively) . 

Under Procedure 1, designated other/designated unidentifiable 
(DO/DU) fields are delineated by card input, ISOCLS clusters the 
LACIE* segment using the starting vectors from the dot data file 
to begin the clustering process. Sun angle correction is 
provided. An unconditional cluster map and a set of cluster 

The cluster statistics, cluster map, and dot data file are input 
to the LABEL processor. Using one of two procedures, k-nearest- 
neighbor or all-of-a-kind , the cluster statistics are labeled. A 
conditional or mixed cluster map may be output to be displayed 
later on the Passive Microwave imaging System/Data Analysis 
Station (PMIS/DAS) or the Interactive Multispectral Image 
Analysis System, Model 100 (Image 100). 


By the use of 
statistics on 
ISOCLS may be 


the transform statistics (TRSTAT) processor, the 
the SAVTAP file output by the processor STAT or 
transformed according to 


Vi' = Ap + b 
K' = AKA^ 


( 2 - 1 ) 


*Large Area Crop Inventory Experiment, for which Procedure 1 was 
developed . 


where 


M ' » transformed mean vector 

% 

A a matrix 

p * mean vector from SAVTAP file 
b * a vector 

K' = transformed covariance matrix 

« 

K => "covariance matrix from SAVTAP file 
A^ * transpose of matrix A 

The transformed statistics are output as a new file on SAVTAP. 

Before proceeding to classification of the MSS image, it may be 
desirable to reduce the dimensionality of the data vectors by 
selecting a smaller set of channels or a linear combination of 
the channels which maximizes some class separability measure . 

The SELECT processor (ref. 3) provides this capability. In order 
to compute the value of the separability measures, the statistics 
calculated using the STAT or ISOCLS processor must be made avail- 
able to the SELECT processor by card deck, tape, or disk file, 
usually the last. The SELECT processor allows the analyst to 
work with subsets of the statistics on the file, if he or she 
desires. Subsets of the. statistics are indicated by the CHANNELS 
and SUBCLASSES control cards, which are defined further in 
table 10-1. 

In addition, the statistics for two or more subclasses may be 
grouped together and considered as one subclass. Grouping the 
statistics for two or more subclasses is equivalent to going back 
through the STAT processor and combining all training fields for 
those subclasses being grouped into one subclass . The grouping 
option is exercised via the GROUP control card defined in 
table 10-1. The subsets and groupings of the statistics provided 
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to the SELECT processor for computation are used only in SELECT 
and are not passed on to other processors. 

The SELECT processor also allows the analyst to evaluate a given 
set of channels using one of three different separability 
measures or to select the best set of channels (k) out of the 
total channels (n) on the basis of one of these separability 
measures . The three separability measures provided are 

a. Weighted average interclass divergence 

b. Weighted average transformed divergence 

c. Weighted average Bhattacharyya distance 

To select the best set of k out of n channels, the analyst may 
use either the without replacement procedure or the exhaustive 
search procedure . A third procedure will find k linear combina- 
tions of n measurements which extremize a given separability 
measure. This procedure, known as the Davidon-Fletcher-Powell 
procedure, outputs the linear combinations in matrix form. All 
the procedures and equations for separability measures referred 
to above are discussed in detail in reference 4. 

After the SELECT processor has determined the subset or the 
linear combination of channels which maximizes subclass separa- 
bility, the supervised classification of the imagery data is 
performed by the CLASSIFY processor. The options available in 
SELECT for grouping and selecting subsets of the SAVTAP file are 
also available in CLASSIFY. However, once the statistics for 
classification have been specified, the classes and subclasses 
are renumbered and referred to in the DISPLAY processor by the 
new numbers . 
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The CLASSIFY proGessor allows the usee to group classes pre- 
viously defined by the STAT or ISOCLS processor into categories 
for the sum-of-densities classification. When a category is 
defined (by class names); all subclasses in each class are 
assigned to the category. The density function for category r, 
P,-(X); is the sum of densities for all subclasses in the cate- 
gory; that is; 

^r 

^ i^l 


where 

= the probability density function for subclass i multiplied 
by the a priori value 

= the number of subclasses in category r 


\ iNw < 




Pixel X is assigned to category r if Pj-(X) > Pg(X) for all cate- 
gories s, s r. Pixel X is further assigned to subclass i if 
(1) i belongs to category r and (2) Pj-j_(X) > PJ-J^^(X) for all sub- 
classes m; m i; and m belongs to category r. 


Obviously a one-to-one correspondence between categories and sub- 
classes reduces the above equation to 

Pj-(X) = Pi-i(X) (2-3) 

When this is the case; the amount of computation required for 
classification can be greatly reduced by the use of thresholds. 
CLASSIFY then has two procedures for classification which use 
this computational reduction to advantage. The sum-of-densities 
rule is used only when categories are defined by the user. 
Otherwise, the classification-by-thresholding procedure detailed 
in reference 4 is used . 




/ 
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The CLASSIFY processor writes a file (MAPTAP, section 4.4 and 
appendix D) containing the subclass number and confidence level 
for each pixel classified; the training fields and statistics for 
► the classes and subclasses actually used in classification; and 

the correspondence between categories, classes, and subclasses, 

S 

' The DISPLAY processor accepts the file output by CLASSIFY and 

generates a line-printer map of the classified data, along with 
several performance tables . In the map, each subclass has a sym- 
j bol associated with it. A threshold option is provided for the 

I analyst to print no symbol (blank) for samples classified with a 

^ confidence level less than some specified threshold value. 

i 

I Performance summaries are provided o.i subclass, class, and cate- 

[ gor^ levels for pixels within each classified field, training 

[ field, and test field which is input to the DISPLAY processor. 

The training or tes't field performance summaries may be obtained 
by fields and/or classes. The DISPLAY processor also provides 
optional output of a classification map (MAPUNT) in either Uni- 
versal or LARSYS II/III format. 

f 

The data transformation (DATATR) processor allows the analyst* to 
use the linear transformation matrix computed by SELECT to create 
a new image data file (TRFORM) . Since thn matrix is computed to 
extremize subclass separability, the k linear combinations out of 
n channels represented by the matrix produce better class con- 
trast when the image is displayed on the PMIS/DAS . In addition, 
the best linear combination of the data can be used to enhance 
the image. The TRFORM file may be output in either Universal or 
LARSYS II/III format. 

The NDHIST processor performs an n-dimensional histogram of areas 
on the MSS data file, for which the user wishes to create scatter 
plots. The fields may be histogrammed on a class, subclass, or 
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per-£ield basis, h line-printer summary of the fields, the num- 
ber of data vectors in each field, and the number of unique data 
vectors histogrammed is given. 

Optionally, if a scatter plot of a classified or clustered area 
is requested, a classification or cluster image data file 
(MAPUNT) from the DISPLAY or ISOCLS processor must be input to 
NDHIST. If this option is exercised, the field or fields input 
to this processor and their older of input must be the same as 
those input to CLASSIFY or ISOCLS. 

Information such as the field, the cluster or subclass number, 
the frequency of occurrence, and the color code for each 
histogrammed radiance vector is written on the n-dimensional 
histogram (NHSTUN) file . 

The SCTRPL processor reads the NHSTUN file , and a two-axis color- 
coded spectral plot (SCTRUN) is output in Universal format. The 
background for the plot may be black or white. 

If more than two channels were histogrammed by the NDHIST proc- 
essor, the data vector is reduced to two components by 

y' = Bx + c (2-4) 

where 

y' = transformed image 
B = a matrix 
X = a data vector 
c = a bias vector 

The location on the scatter plot for each vector in the NHSTUN 
file is determined by its radiance values (if only two channels 
were histogrammed) or by two linear combinations of radiance 
values (if more than two channels were histogrammed), 

2-9 


// 


The color for a pixel is assigned by 

• Original radiance values 

• Mean vector of the cluster or subclass to which the pixel was 
assigned during clustering or classification 

• Mean vector of the test or training field from which the pixel 
was extracced 

• User-defined colors 

• Color extraction from a different pass when using multi- 
temporal Landsat data 

Optionally, for pixel color assignment, the SAVTAP file created 
by the STAT or ISOCLS processor or card images containing color 
codes may be input . 

Optionally, a line-printer pixel frequency or log of pixel fre- 
quency (base 2) plot is given. The plot is printed with up to 16 
different symbols. 

There are support processors to assist the analyst. DAMRG per- 
forms channel or spatial merger of image data. GTTCN and GTDDM 
accomplish the labeling of pixels and dots (selected pixels) on 
the basis of ground truth files. 

Figure 2-1 is a diagram showing the principal processing options 
and paths in EOD-LARSYS . 

2.2 OPERATION 

The processors described here can be executed in two modes, batch 
or interactive. Both can be run from the direct-line terminals 
of the computer facilities in building 17, or anywhere that tele- 
phone contact can be established with the computer at Purdue. At 
present, this includes two terminals in the Lockheed buildings in 
Nassau Bay. 
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For batch or interactive operations, decks ofi cards (or files of 
card images) need to be prepared as shown in this document. Prom 
a direct-line terminal, an analyst issues instructions to read 
decks of cards, using the card reader. 

Use of the editor to prepare files of control card images from 
the terminal is rather more complex, but it is much to be 
preferred . 

The sections that follow give the practical steps for using EOD- 
LARSYS as implemented at Purdue LARS. Sections 2.2.1 and 2.2.2 
tell how to log bn and off the system. Section 2.2.4 describes 
the use of the editor to create, modify, and erase card image 
files. Section 2.2,5 tells how to run a program. These proc- 
esses are also traced in figure 2-2. 

2.2.1 TO START: LOG ON TO THE SYSTEM 

TO operate in either batch or interactive mode, the user must 
activate a terminal and establish telephone contact between term- 
inal and computer. For the two dial-up terminals at Lockheed, 
make certain the terminal and coupler are turned on. Then dial 
the number of the multiplexer in building 17 . When a high- 
pitched computer noise is heard, insert the telephone in the 
coupler , 

Prom this point on, instructions for the dial-up terminals are 
identical to instructions for the direct-line terminals. 

To get the attention of the system, depress the N key, then the 
carriage return (CR) . Appearance of the carat (>) signifies that 
you are in control program (CP) mode. Now log on by typing 

LOGON XXXXKX YYY 

where XXXXXX is a user identification number and YYY is the pass- 
word. If this information is acceptable, the system will ask for 
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your name. If not, you will need to make a correction or simply 
try again. The system will then type a log-on message (LOGMSG), 
giving certain information regarding system operation. 

At this point, if you plan to run interactively, you should type 

DEF STOR IM 

This will allocate 1 megabyte of virtual memory for the job you 
are about to run. Without this, the program will not be able to 
operate for lack of space in the computer. (For batch opera- 
tions, storage has been previously defined.) Now type 

IPL LARSYSPl (CR) 

The system will respond with 

EOD LARSYS READY 

signifying that you have successfully logged on to the system and 
are ready to begin. Control now lies with the IBM CMS 3031 and 
with the JSC disk attached. To start the prompter, type 

EODLARSYS 

This calls the EOD-LARSYS program. From here, follow instruc- 
tions in section 2.2.4 or 2.2.5. The first part of figure 2-2 
shows this entire sequence, together with all responses by the 
system. 

2.2.2 TO STOP; LOG OFF THE SYSTEM 

To stop using the system, the user must log off. To do this, 
depress the BREAR key, and then type 

LOG (CR) 

In batch processing, this is normally done after the terminal 
displays the READY message (if done earlier, the job may be 
lost), In interactive operations, it can be done at any time. 


2.2.3 CARDS OR CARD IMAGES 


EOD-LARSYS can be run either with physical cards, submitted to a 
card reader, or as files of card images. These cards and card 
images are the control cards described in this document. The 
physical cards must be used with the card reader adjacent to the 
direct-line terminals in building 17. Card images can be used 
from any location. 

When physical cards are used, the foregoing instructions are suf- 
ficient. The cards are fed to the card reader when indicated by 
the program. Output must be directed to HOUSTON. When cards are 
used, operations are normally run as batch, usually overnight. 
Figure 2-2 gives a complete set of computer messages and 
responses for such a job. 

If physical cards are not to be used, the user must know how to 
create, modify, and destroy card image files. A file is a col- 
lection of data stored on disk or tape. A file is identified by 
three attributes _ file name, type, and mode. The filename is 
specified by up to eight characters. Files to be read by Fortran 
programs should have filetypes of the form 

^■^n Pm 

where n is the Fortran unit number (00-99) and m the relative 
file number (000-999). If there is only one file for a partic- 
ular unit, the filetype is arbitrary; e .g . , CC . Filemode, for a 
file on the user's permanent disk, is An, where n is defaulted 
to 1-, 

To use EOD-LARSYS in the interactive mode, the user should create 
a control card file on disk. This is done using the editor, as 
described in the next section. 


2.2.4 USING THE EDITOR TO CREATE, MODIFY, AND ERASE FILES 

After typing EODLARSYS, you may edit a file by responding EDIT to 
the next prompt. (You may also call EDIT directly from CMS 370.) 
EDIT here means that you can create a new file, or modify an 
existing one, or delete one. Several options are described 
below . 

To create a new file, type I (CR), for input. At this point you 
can type out the card images, much as though you were preparing 
cards on a keypunch device. After furnishing the name of the 
file (such as BARLEY GC) , you might type the following; 


FORMAT 1 (CR) 

$ISOCLS INPUT/UN1T=11,FILE=1 (CR) 

DATA (CR) 

$EXIT ' (CR) 

(CR) 


To stop furnishing text, type two carriage returns in a row. 

To change an existing file, you go into the EDIT mode in the same 
way. You can print out the entire file on the console by typing 

TOP 

T* (For TYPE *) 

TOP 

The last TOP returns you to the top of the file. 

If you type a wrong character, you may erase it by typing For 

example, to finish typing CAROLYN after you started with CARIL, 
you will have the following line of text on your screen: 

CARIL@@OLYN 

Notice that the BACKSPACE key will not function properly for this 
use. To erase the whole line, type [ (CR) at any time. 
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The simplest way to locate a line to be changed, or a place to 
insert more lines, is by typing 

N (CR) 

until that line appears. N stands for NEXT. At this point you 
might insert more lines by typing 

I (CR) 

for input and then the lines to be inserted. Or, you might 
change characters by typing 

C /XXX/YY/ 

where XXX is the incorrect string of characters and YY is the 
string to replace it. You might also simply delete the line by 
typing 

DEL 


for deletion. 


To erase a file, enter 

ERASE (filename) (filetype) (filemode) (CR) 

At the end of an editing session, you should type FILE to store 
the modified file. If you neglect to do this, your changes will 
be lost. 

More details on editing can be found in the "IBM Virtual Machine 
Facility 1370: CMS Command and Macro Reference." 

2.2.5 TO RUN A PROGRAM 

Before running a program, you must define the complete set of 
EOD-LARSYS control cards. You can punch the cards physically, 
or (preferably) you can prepare a file of card images as just 
desc..ibed . 
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You may execute in two ways: interactive or batch. The inter- 

active way allows you to sit at ul.e terminal/ run a program/ and 
receive the results on the terminal (or/ in building 17, on the 
line printer) . In batch, you submit a job and receive the 
results later on the line printer. 

To run a program, type the location of the cards or card images 
when prompted (READER or DISK) . If on disk, the system will ask 
for the filename. Although the name will appear with "CC" after 
it, you will not need to type more than the name. 

The system will then ask if you wish to run interactively or 
batch . 


The system will ask where to furnish the printer output. You 
will reply HOUSTON to this question if results are to be written 
to the line printers in building 17, the normal case. In certain 
cases it may be reasonable to write to the terminal screen; write 
TERMINAL for this case . 

Type in the data tape number when requested. The tapes must be 
physically located in "Flexlab 2," the computer room at LARS. 

The system will then ask whether to save various intermediate 
results on file or tape. Since the questions are asked even when 
the intermediate results will not be produced, the normal 
response is N (CR) . Respond as appropriate. 

2.2.6 NOTES ON PROCEDURES FOR MINISGAN 

After you have entered the IPL LARSYSPl command, you may enter 
EODSCAN instead of EODLARSYS . This command will bring in a 


module that can be used to scan the control card file for 
possible additional options. These new options are as follows: 

1. whenever the DATA card occurs 'in the control card image file, 
you may choose to use one of three new formats ; 

a. If the data are known to the LARS data base by segment/ 
acquisition, you may use one of the following formats; 

DATA UNIT=VV, .SEG=XXXX, ACQ=YYY 

DATA INPUT/UNIT=W, SEG=XXXX, ACQ=YYY 

SEG may be abbreviated S. ACQ may be abbreviated A. 

The three keys may be in any order . 

b. For any data set on tape (for example, a merged data 
set), you may use one of the following formats; 

DATA UNIT=VV, PILE=XX, TAPE=YYY 

DATA INPUT/UNIT=VV, PILE=XX, TAPE=YYY 

TAPE may be abbreviated T, and the three keys may be 
in any order . 

c. If the data set desired is on a disk file, you may use 
one of the following formats; 

DATA UNIT=XX,NAME=' FILENAME FILETYPE FILEMODE' 

DATA INPUT/UNIT=XX,NAME=' FILENAME FILETYPE FILEMODE' 

NAME may be abbreviated N. The two keys may be in 
either order. The single quotation marks are required 
around the name DATA. 

d. The currently existing options are still acceptable. 

2. Whenever any card that uses one of the following formats 

DATA UNIT=, FILES 

DATA INPUT/UNIT=, FILE= 

DATA OUTPUT/UNITS, FILE= 

is in the control card file, then you may use only 

format type lb or Ic . 
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3. The READ control card image in processor GTTCN may be coded 
using format la, lb, or Ic. 

% 

If you choose to use one of the new formats for your DATA card 
type, then when the prompting EXEC asks if the job requires an 
MSS tape, you should answer NO. 

All other options currently available under EODLARSYS are still 
valid with EODSCAN. 


2.2.7 TROUBLESHOOTING 

% 

It is not feasible to furnish responses to all problems that may 
occur. The following are the principal ones that have occurred 
in the past . 


xXuc uwiSc waUac a Smaxx juIujjXc wx Xcuuci.o uw uS 

printed, and the system will return to CP status (shown by the 
carat). When this happens, type B (CR) to begin again. 


If the diagnostic READ ERROR appears, merely touch the CR key and 
the system may recover. 

If the system is not responding properly to typed commands, the 
telephone connection may have been broken. When this happens at 
remote terminals, the carrier light will not be lit. When this 
happens, start over by logging on. If you were editing, check to 
see the status of your files. If more than 15 minutes elapses, 
you may lose all edits. 








LOGON 


>L0G0N JSC700 SUE 

ENTER NAME: >GI0DINGS 

LOGMSG - 08:03:47 EST SATURDAY 05/05/70 
* NEXT SCHEDULED SHUTDOWN IS SATURDAY 5/5 AT 17:00 
LOGON AT 10:29:41 EST SATURDAY 05/05/79 

>IPL LARSYSPl 

EOD LARSYS READY, 

DEV 19C DOES NOT EXIST 
Y (19C) R/0 

R: T=0.17/0.27 10:30:07 


>EODLARSYS 

Question 1. ARE THE EOD-LARSYS INPUT CARDS IN THE CARD READER, 

ON DISK, OR DO YOU WISH TO CREATE OR MODIFY THEM, 

OR DO YOU WISH TO GET A STANDARD SET FROM THE 
EOD-LARSYS SYSTEM DISK? (READER, DISK, EDIT, 

OR GET) 

Possible responses 

A. READER (Default) 

Implies EOD-LARSYS input cards are in your card reader. 

B. DISK OFILENAME (Will ask for filename, if not given.) 
WHAT IS THE FILENAME OF THE EOD-LARSYS INPUT CARDS? 
FILENAME 

Implies EOD-LARSYS input cards are in disk file 
"FILENAME CC." 

C. EDIT OFILENAME 

WHAT IS THE FILENAME OF THE EOD-LARSYS INPUT CARDS THAT 
YOU WISH TO CREATE OR MODIFY? 

FILENAME 

EDIT 

EDIT commands 

EDIT 

FILE 

Implies EOD-LARSYS input cards will be edited on disk, 
or will be created on the disk via edit. 

D. GET OFILENAME (Will ask for filename, if not given.) 


Figure 2-2.- EOD-LARSYS queries and responses. 


possible errors 

E 00001 FILE ‘FILENAME' CC A MOT FOUND 
* 

This error occurs when question 1 is answered by 
"DISK FILENAME" and the specified file does not 
exist. {If this error occurs, question 1 is 
reissued . ) 


Question 2. 00 YOU WISH TO RUN INTERACTIVELY AT THE TERMINAL 

* OR HAVE YOUR EOO-LARSYS JOB SENT TO A BATCH 
MACHINE? (INTER OR BATCH) 

Possible responses 

A. INTER (Default) 

Implies you wish to run interactively. 

B. BATCH 

Implies EOD-LARSYS input cards will be sent to a 
batch machine for processing. 

wOtB; If a batch job is to be run and the user specified 
"READER" for question 1, the following error may occur. 

E00002 THERE WERE NO CARDS IN YOUR CARD READER. 

READ THEM IN AND THEN TYPE 'READY' 

(Default response here is READY.) 

Question 3. AT WHICH SITE DO YOU WISH TO RECEIVE THE PRINTER 
OUTPUT (AND OPTIONALLY PRINT STATUS)? 

possible responses 

SITE <> HOLD/NOHOLD; {Default site is where command; 
e.g., HOUSTON HOLD default print status is HOLD.) 

Possible errors 

E0003A 'SITE' IS NOT A VALID PRINT SITE 

(If this error occurs, question 3 is reissued.) 

E0003B 'STATUS' IS NOT A VALID HOLD STATUS 
PLEASE ENTER HOLD OR NOHOLD 


Figure 2-2.- Continued. 


Question 4. WILL YOUR EOD-LARSYS JOB BE USINQ A MSS DATA TAPE? 
(YES OR MO) 

Possible responses 

A. YES (Default) 

The above question will not be asked if the user is 
going to run batch since a tape is required for 
batch. However, the following line will be typed 
for either interactive or batch mode. 

TYPE IN MSS DATA TAPE NUMBER 

Possible response 

NNNN ; 

e.g., 1267 

B, NO 

Implies a MSS data tape is not needed for this job. 

Question 5. DO YOU WISH TO SAVE ANY INTERMEDIATE RESULTS 
PRODUCED BY EOD-LARSYS, OR USE ANY PREVIOUSLY 
SAVED ONES? (YES OR NO) 

Possible responses 

A. NO (Default) 

Implies intermediate results will be written to a 
temporary disk and will not be available after the 
job finishes execution. 

B, YES 

The following question will then be asked about each of 
the intermediate results. 

CLASSIFICATION MAP (NO, SAVE, OR USE) 

Possible responses 

A. NO default) 

Implies you do not wish to save the classifica- 
tion map or use a previously generated map. 

B. SAVE _ OFILENAME 

Implies you want the classification map stored 
on your permanent disk. 


Figure 2-2.- Continued. 
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C, USE OF I LE NAME 

Implies you want a classification map that is 
stored on your permanent disk to be used. 


N-DIMENSIONAL HISTOGRAM 

(NO, 

SAVE, 

OR 

USE) 

TRAINING STATISTICS 

(NO, 

SAVE, 

OR 

USE) 

HISTOGRAM 

(NO, 

SAVE , 

OR 

USE) 

DOT DATA 

(NO. 

SAVE, 

OR 

USE) 

STATISTICS 

(NO, 

SAVE , 

OR 

USE) 

TRANSFORMATION MATRIX 

(NO, 

SAVE, 

OR 

USE) 


THE FOLLOWING INTERMEDIATE RESULTS MAY BE SAVED ON OR 
USED FROM EITHER YOUR PERMANENT DISK OR A TAPE. 

SCATTER PLOT (NO, SAVE, OR USE) 

Possible responses 

A. NO (Default) 

B. SAVE OFILENAME 

Implies the scatter plot will be saved on your 
permanent disk. 

C. SAVE ONNNN 

Implies tne scatter plot will be saved on 
tape NNNN file MM, where the default file 
number is 1 . 

D. USE OFILENAME 

Implies the previously saved scatter plot is on 
your permanent disk. 

E. USE ONNNN 

Implies the previously saved scatter plot is on 
tape NNNN file MM, where the default file number 
is 1 . 

TRANSFORMED MSS DATA (NO, SAVE, OR USE) 

CLUSTER MAP (NO, SAVE, OR USE) 


Figure 2-2. ^ Continued. 


I£ feho uooL’ ia vjoinvj to run hia ov her j^b bafeuhi the 
fiollowinq moorn-uio ia printed and only the t'OUowimi 
w|ueotiono will bo aakod ainoo infeormodiato roaulfea may 
only be aaved on or uaed firom tape. 

THE PdLLOWING INTERMEDIATE RESULTS MAY BE USED FROM 
AND/OR SAVED ON TAPE. 

SCATTER PLOT (NO, SAVE, OR USE) 

TRANSFORMED MSS DATA (NO, SAVE, OR USE) 

CLUSTER MAP (NO, SAVE, OR USE) 

The only valid teaponaea £or batoh piroceaainq are A, C 
and E liated under "SCATTER DI.OT" above. 

Doaaible errora 

E0005A TYPE IS NOT PERMITTED FOR THIS DATA SET 

Poc.sible errora lor USE s'* FILENAME 

E0008B 'FILENAME' DOES NOT EXIST ON YOUR A-DISR 

Poaaible errora For SAVE OPILENAME 

EQOOSC SAVE IS NOT A VALID OPTION SINCE YOU DO NOT 
HAVE AN A-DISK THAT CAN BE WRITTEN ON. 

EQ0Q5D THERE IS NOT ENOUOH SPACE ON YOUR A-OISK TO 
SAVE 'FILENAME'. TYPE A SERIES OF CMS 
COMMANDS TO MAKE ROOM. TYPE READY WHEN 
DONE OR TYPE SKIP IF YOU DO NOT WANT TO 
MAKE ROOM. 

Sinoe Files are not saved until afiter the 
EOD-LARSYS job ia completed, error E0005D 
will not appear until then. 

Question 6. DO YOU WANT TO RUN ANOTHER JOB? (YES OR NO) 
Possible responses 

A. YES (Default) 

Then question 1 ia asked again and so on. 

B, NO 

An exit to CMS ia taken. 

Figure 2-*2.- 


Con tinned . 


After the job has been sent to the batch machine, the following 
message is typed . 

YOUR JOB HAS BEEN SENT TO THE BATCH MACHINE 

Then, question 6 is asked of the user, and so on. 


Figure 2-2.- Concluded. 



3 . INPUT 


3.1 IMAGE TAPES 

Every processor except SELECT, TRSTAT, SCTRPL, and LABEL uses an 
MSS data file (DATAPE) . The assignment defaults to logical 
unit 11, but the user may assign any unit available by input of 
the DATA control card. For details, see the unit assignment 
chart in section 4 and the control card section for each 
processor. The file may be in LARSYS II/III or Universal format 
(defined in appendixes B and C, respectively) or in certain 
Landsat formats (defined in references 5 and 6) . 

The control card DATA allows the user to communicate the number 
of the MSS data file to be processed and the logical unit assign 
ment . This is optional input to every processor that requires 
MSS data. The first file of the tape will be processed unless 
otherwise specified by the DATA control card. In executing the 
same and/or different processors consecutively, the DATA control 
card may be input only to the first processor executed if the 
same file and logical unit are to be used throughout the execu- 
tion . For example , 

$HIST [File 2 of the MSS data tape 

DATA UNIT=11,F1LE=2 (DATAPE) assigned to unit 11 

(Other control cards) is processed by GRAYMAP as 

*END well as HIST,] 

(Field definition) 

§END 

$ GRAYMAP 
CHANNELS 5,6 
*END 

(Field definition) 

$END 
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3.2 CARDS AND CARD IMAGES 


Card input to the system must be one of the types discussed 
below. It should be noted that card image files are normally 
used in remote processing applications. In the discussion 
following, "card image" should be understood for "card." 

3.2.1 PROCESSOR CARDS 

A processor card identifies the processor that is to be 
executed. The system monitor routine calls the appropriate 
processor, which initiates the loading of all routines used by 
the processor. The processor card is always a $ symbol followed 
by the processor name and must always be punched left justified 
beginning in column 1 . No blanks are allowed . The $ symbol and 
the first five characters are the unique processor identification 
used by the system monitor routine. 

Below is a list of all processor cards recognised by the system, 
along with the section in which each processor is described. 


$HIST 

Section 

6 

$GRAYMAP 

Section 

7 

$STAT 

Section 

8 

$IS0CLS 

Section 

9 

?SELECT 

Section,. 

10 

$CLASSIFY 

Section 

11 

$DISPLAY 

Section 

12 

$ DATATR 

Section 

13 

$TRSTAT 

Section 

14 

$NDHIST 

Section 

15 

$SCTRPL 

Section 

16 

$ DOT DATA 

Section 

17 

$LABEL 

Section 

18 

$ DAMRG 

Section 

20 

$GTDDM 

Section 

21 
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$GTTCN 
$TESTSP 
‘ $BXIT 


Section 22 
Section 23 

Execution terminates when this card is 
encountered . 


3.2.2 CONTROL CARDS 

Each processor has its own set of control cards which allow the 
user to exorcise various options in the particular processor or 
to change the default value assigned to certain parameters in the 
system . These cards must immediately follow a processor card . 

The control cards are identified by a keyword in columns 1 
through 10 of the card . Only the first four characters are used 
for testing. In columns 11 through 72, the parameter values or 
options are indicated. These columns are free form, blanks are 
ignored (unless of legitimate parameter value) , and multiparam- 
eter values or options are separated by commas. Columns 73 
through 80 of the card are not used. With the exceptions of the 
B’QRMAT, *END, $END, and in some cases the STATFIbE cards, control 
cards may occur in any order. (The STATt’ILE control card excep- 
tion is noted in the section for the appropriate processor.) If 
the list of parameter values for a given keyword is too long for 
one card, tha remaining values can bo input on another card with 
the same keyword. (The continuation of a CATEGORY control card 
is slightly different; see section 11, table 11-1.) In every 
processor, the *END control card indicates the end of a set of 

control cards, and the $END card indicates the end of the field 

definition card input. The FORMAT card defines the format of the 
MSS data file by a 1 or a U (Universal), a 2 or an L (LARSYS 11/ 

III), a 3 or a B (Landsat bulk), or a 4 or an E (EROS*) in col- 

umn 11 (or subsequent columns) & This card precedes all others in 


*Earth Resources Observation Systems Data Center at Sioux Falls, 
South Dakota . 
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a job setup, The user should ensure that all files written in 
the run are consistent in format . 

Ancillary control cards, common to all processors, can be used to 
control the titles on printout sheets. As shown in table 3-1, 
defaults present standard titles and the current date . An 
optional COMMENT card can be used to furnish further identifica- 
tion on output sheets . 

3 .2.3 CLASS , SUBCLASS, AND FIELD DEFINITIONS 

A field is a specific block of data to be extracted from the 
input MSS data file and processed . It is defined by a sample 
increment, a line increment, and from 1 to 10 vertices, option- 
ally, the user may associate a name with each field . The alpha- 
numeric field description is located in columns 1 through 6. In 
columns 11 through 72 , sample and line increments are separated 
by a comma and enclosed together in parentheses. A comma sepa- 
rates the increments and each of the following vertices . The 
vertices must be arranged in clockwise order . Sample and line 
numbers which describe a vertex are separated by a comma and 
enclosed together in parentheses. The sample number must be 
given first for each vertex . More than one card may be used to 
describe a field. An asterisk occurring after a vertex indicates 
a continuation card is to be read beginning in column 11. A ver- 
tex must be completed on a card and cannot be split between two 
cards. The numbers which describe the increments and vertices 
must be integers . 

It is the user's responsibility to ascertain that all defined 
fields are within the bounds of the MSS image. In determining 
which pixels belong to a particular field , the EOD-LARSYS 
examines the pixel intercepts of each scan line with each side of 
the field. The pixel intercept X, with the scan line L and the 
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side defiined by vertices and (X2/Y2)/ is calculated by 

the equation 



The value of X is computed as a floating-point number? however, 
the actual pixel intercept must be an integer number. Therefore 
if the fractional part of X is greater than one-half, the pixel 
intercept is the next higher integer number. If the fractional 
part of X is less than one-half, the pixel intercept will be the 

next lower integer number . When the fractional part of X is 

exactly one-half, the integer pixel intercept depends on the 
direction of movement from the point (Xj^, to (X2 ? Y2) • If Y^^ 

is less than Y2 , the pixel intercept is the next higher integer. 

If Yjl is greater than Y2/ the pixel intercept is the next lower 
integer number. 

After all pixel intercepts for a given scan line have been deter 
mined, the intercepts are taken in pairs and all pixels between 
and including the pair of intercepts are included in the field,' 
In the following example for scan line L, all pixels between and 
including and are included , and all pixels between and 
including P3 and P^ are included. 




The following three examples describe field definition cards and 
the fields they define . In example 1, the sample and line incre 
raents are equal to 1 for field FI, and there are four vertices . 

FI (1,1) , (412,231) , (422,230) ,(429,246) ,(419,147) 


Sample 


CN 

n 

■3!' 

in 

VD 

r' 

CO 

as 

O 

rH 

CN 

M 


in 


C' 

CO 

as 

rH 

rH 

rH 

iH 

H 

iH 

iH 

rH 

(N 

CN 

CN 

CN 

CN 

cl 

CN 

CN 

CN 

CN 

'3' 


•>3< 

■<3< 


>51* 

«a< 

>3’ 



■«< 

N* 




•3* 

N* 





P2 


(2,3) ,(412,231) ,(422,230) ,(429,246) ,(419,247) 

Sample 


fS 


U5 

CO 

Q 

CM 

•q' 

VX5 

CO 


iH 

H 

i"H 

CM 

CN 

<N 

CM 

CM 




■q* 

■q* 

V 



'3' 


233 

236 

Line 239 
242 
245 


In example 3, the sample and line increments tor field W187 are 
equal to 1, and there are six vertices. 

W187 (1,1) ,(324,266) ,(355,264) ,(338,271) , 

(330,272) ,(329,269) ,(326,269) 

Sample 


■q* 

in 

CD 


CO 

a\ 

o 

pH 

CN 

m 

■q* 

in 

CD 


CO 

CN 

CN 

CN 

CN 

CN 

CN 

ro 

cn 

cn 

in 

cn 

m 

m 

cn 

m 

n 


m 

n 

cn 

cn 

n 


cn 

cn 

m 

m 

cn 

m 

on 


264 

265 

266 
267 

Line 268 

269 

270 

271 

272 


Except tor SELECT, TRSTAT, and scatter plot (SCTRPL) , every proc- 
essor accepts the input of field definition cards. Field defini- 
tions are always input between the *END and $END control cards . 
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The exact way of using these cards differs from processor to 
processor, as is shown in table 3-2* In the STAT and ISOCLS 
processors, fields must be associated with a class or subclass 
name. In the DISPLAY processor, fields may be test fields or 
designated fields . In the NDHIST processor, fields are associ- 
ated with class or subclass and may be test, training , or any 
user-defined field. 

The fields defined in STAT and ISOCLS are called training fields , 
and the data within these fields are used for computing statis- 
tics. Training fields are grouped into subclasses , and subclasses 
are further grouped into classes, using the STAT processor . In 
ISOCLS, training fields are grouped into classes , and the 
clustering procedure breaks the class data into subclasses 
(clusters) . To allow for these groupings , cards bearing a class 
name and a subclass name are necessary. 

A class name card has the keyword CLASS beginning in column 1 and 
the alphanumeric name of the class left justified in columns 11 
through 14 of the card . Blanks should not be embedded in the 
class or subclass names . 

A subclass name card has the keyword SUBCLASS beginning in 
column 1 and the alphanumeric name of the class left justified in 
columns 11 through 14 of the card . 

In STAT, a CLASS card must immediately follow the *END control 
card. The CLASS card is followed by one or more SUBCLASS cards , 
each of which must be followed by one or more field definition 
cards. See the example for STAT (section 8.4.4). 

In ISOCLS, a CLASS card must immediately follow the *END control 
card. The CLASS card is immediately followed by one or more 
field definition cards. The data from the fields associated with 


a given class name are clustered as one data set. The class is 
broken into subclasses (clusters) which do not have field bound- 
aries, So, even though statistics are computed on a subclass 
level, training fields cannot be associated with subclasses in 
ISOCLS . See the example for ISOCLS (section 9.5.4) . 

In DISPLAY, test fields ( if input) must be identified by a pre- 
viously defined class or subclass name . When assQciated with 
classes, a CLASS card should immediately follow the *END control 
card . Test fields for that class should follow immediately . 

When associated with subclasses, a SUBCLASS card should immedi- 
ately follow the *END card, followed by the test fields for that 
subclass. 

Designated fields are the other type of field input to DISPLAY. 
Fields may be DU or DO. For input of designated fields, a card 
with the keyword DESIGNATE beginning in column 1 and the keyword 
OTHER or UNIDENTIFIABLE beginning in column 11 must precede the 
field definition cards. See section 12.4.4 for sample input of 
test and designated fields. 

3.2*4 SPECIAL SYSTEM FILES 

The card image files described in this section are special files 

» 

normally output from one processor to be used at some future time 
as input to another processor. However, if the user can obtain 
all of the information needed for any of the special card image 
files from some other source, such information may be input 
directly to the processor if the formats described in this sec- 
tion are followed . 

These files are always referred to in the job setup by the con- 
trol cards for the particular processor. The first card image of 
each file acts as a keyword which initiates the input of the 
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£ile , It is not necessary to input the same £ile to more than 
one processor in the same run. 

3 . 2 . 4 . 1 Module STAT File 

The module STAT rile is optional output from the STAT, ISOCLS, 
and TRSTAT processors . It contains the statistics (mean vectors 
and covariance matrices) for all the subclasses input to STAT, 
the statistics for the clusters computed by ISOCLS, or the trans- 
formed statistics for all subclasses or clusters input to TRSTAT. 
These statistics are needed in the computation of the probability 
density functions in CLASSIFY and the computation of separability 
measures in SELECT. 

This file also contains all the training field boundaries, the 
class and subclass numbers to which the training fields belong, 
the class and subclass names , the number of subclasses in each 
class, and the number of points in each subclass or cluster. By 
defining the required training fields in STAT, the user has abso- 
lute control over the data samples that will define a subclass 
from the MSS data file. Every data sample occurring in any one 
of the training fields defined by a particular subclass is used 
in computing the mean vector and covariarice matrix for that 
subclass . 

In the clustering processor ISOCLS, the user has no control over 
the specific samples that comprise a cluster. The processor 
determines which data samples are used in computing the mean 
vector and covariance matrix for each cluster. Because it is 
desirable to use these cluster statistics in other processors, 
the ISOCLS processor creates a file in the same format as that 
used in the STAT processor. The file may be punched if desired. 
Training fields are associated with classes rather than sub- 
classes. Clusters are given a six-character name. The first 
three characters are the first three characters of the class name 
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associated with the cluster, and the last three characters are 

digits. The digits for the subclasses are in sequential order. 

» 

When the module STAT file is input to the CLASSIFY or SELECT 
processor, the user may request subsets of the statistics to be 
used for classification or channel selection via the SUBCLASS and 
CHANNELS control cards in both processors . Subclasses are num- 
bered as they were input to STAT, and clusters are numbe.red as 
they were created in ISOCLS. The channels are numbered as they 
occur on the MSS data file . To select a subset of the statistics 
in the module STAT file, the user should indicate by number the 
subclasses and/or channels he or she wishes to use . (Unless the 
user has previous knowledge of the number of clusters in the 
module STAT file , he or she cannot accurately select a subset of 
the clusters when executing ISOCLS in conjunction with another 
processor . ) 

The first card in the module STAT file acts as a control card , 
with the keyword MODULE starting the input of the remainder of 
the file. The entire file is composed of the card image types 
listed below. All integers should be right justified in the 
specified field, and alphanumeric characters should be left 
justified in the specified field. 

# Card type 1 — Keyword MODULE in columns 1 through 6 . 

• Card type 2 — Number of classes, subclasses, channels, fields, 
and vertices for training fields. 

Columns Format Definition 

7-10 14 Number of training classes from STAT or 

I;' „ CLS 

19-20 12 Number of training subclasses from STAT 

(clusters from ISOCLS) 
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Columns 

Format 

Definition 

29-30 

12 

Number of channels used in computing 
statistics 

38-40 

13 

Number of training fields input to STAT 
or ISOCLS 

49-52 

14 

Number of vertices in all the training 
fields 

• Card type 

3 — Actual channels used in computing statistics. 

Columns 

Format 

Definition 

11-12 

12 

Channel 1 

13-14 

12 

Channel 2 

15-16 

• 

12 

• 

Channel 3 

• 

« 

69-70 

« 

12 

• 

Channel 30 

« Card type 
the set .* 

4 — Training field information: The first card of 

Names should not exceed four characters . 

Columns 

Format 

Definition 

1-6 

A4 

Field name 

11-12 

12 

Number of the class associated with this 
field 

*Card types 4 

and 5 

define a training field. To complete the set 


of information for one training field, one card of type 4 and 
one or two cards of type 5 are required . The number of card 
sets is determined by the number of training fields. 
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Columns 
o 1 “) 

^ JL *« «« 


31 - 3 : 


Format Dolinibion 

12 Number o£ the vsubolaso assoGiabud with this 
Eield input to STAT (Since ISOCLS associ- 
ates fields with classes, ISOCLS dummies 
this information by setting it equal to 0 . ) 

12 Number of vercicos for this field, 
including closure point 


• Card type 5 — Vertices for the training field: Up to 10 ver- 

tices plus the closure point are allowable for each training 
field, 7 vertices per card with coordinates ordered (sample, 
line) . The coordinates are listed in a clockwise manner, with 
the coordinate having the smallest sample number listed 


first. ^ 



Columns 

B'ormat 

Definition 

11-lS 

15 

Sample number of first vertoK 

16-20 

15 

Line number of first verte.'i 

21-25 

15 

Sample number of second vertex 

26-30 

• 

15 

• 

Line number of second vertex 

f 

* 

76-80 

* 

15 

• 

Line number of seventh vertex 

Card type 
in field ; 
classes . 

6 — Class names, nine names per. card, left justified 
The number of cards is determined by the number of 

Columns 

Format 

Definition 

11-16 

A4 

Four-character class name for first class 

19-24 

A4 

Four-character class name for second class 
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Columns Pomwat 


Definition 


27-32 


A4 


Four-charactet class name foe third class 


75-80 


A4 


Four-character class name for ninth class 


• Card type 7 — Number of subclasses in each class, 24 per card 
The number of cards is determined by the number of subclasses 


Columns E’ormat 


Definition 


9-10 

12 

Number 

of 

subclasses 

in 

first 

class 

12-13 

12 

Number 

of 

subclasses 

in 

second class 

lS-16 

• 

12 

• 

Number 

of 

subclasses 

• 

in 

th ird 

Glass 

• 

78-79 

• 

12 

Number 

of 

• 

subclasses 

in 

24th 

class 


• Card type 8 Subclass names, 10 per card: The number of 

cards is determined by the number of subclasses. 


Columns Format 


Definition 


9-14 

A 4 

Four-character 

subclass 

name 

for 

firs t 



subclass 





16-21 

A4 

Four-character 

subclass 

name 

for 

second 



subclass 





23-28 

A4 

Four-character 

subclass 

name 

for 

third 

• 

• 

subclass 

« 




• 

72-77 

• 

A4 

Pour-character 

• 

subclass 

name 

for 



10^*^ subclass 
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To GoraplebG the set of statistics for one subclass, the following 
three types of cards are grouped together. The number of sets of 
cards is determined by the number of subclasses. 

• Card type 9 — Number of points in this subclass. 

Columns Format Definition 

13-20 18 Number of points in this subclass 

« Card type 10 — Mean vector for this subclass, five values per 
card; The number of cards is determined by the number of 
channels . 


Columns 

Format 




Definition 


6-20 

E15.8 

Mean 

for 

first 

channel 

for 

this subclass 

21-35 

E15 .8 

Mean 

for 

second 

channel 

•for 

this subclass 

36-50 

E15.8 

Mean 

for 

third 

channel 

for 

this subclass 

51-65 

E15 .8 

Mean 

for 

fourth 

channel 

for 

this subclass 

66-80 

E15 .8 

Mean 

for 

fifth 

channel 

for 

this subclass 


• Card type 11 Covariance matrix for this subclass : Only the 

lower triangular portion of the matrix is output; the number 
of values input for this matrix is equal to (number of 
channels) x (number of channels + l)/2. Five values are 
written on each card image in the order indicated. 

1 

2 3 

4 5 6 

7 8 9 10 



j 
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Columns 


Format 


Definition 


6-20 

E15.8 

Element 

1 

of 

matrix 

21-35 

E15 .8 

Element 

2 

of 

matrix 

36-50 

E15.8 

Element 

3 

of 

matrix 

51-65 

E15.8 

Element 

4 

of 

matrix 

66-80 

E15 .8 

Element 

5 

of 

matrix 


3*2. 4. 2 B-Matrix File 

The B-matrix file is an optional output of the SELECT processor 
when the Davidon-Fletcher-Powell procedure is used. The file 
contains a transformation matrix which extremizes a given 
separability measure for the subclasses being used. The matrix 
is optimized using the Davidon-Fletcher-Powell procedure. The 
linear transformation of the original measurements can be used in 
the CLASSIFY, DATATR, TRSTAT, or SCTRPL processor to reduce the 
dimensionality of the data and/or statistics. 

The B-matrix deck, or corresponding file, is an optional input to 
SELECT, CLASSIFY, and SCTRPL, and a required input to DATATR and 
TRSTAT. When input to SELECT, the matrix is used to evaluate a 
specific separability measure or it is used as a first guess for 
the Davidon-Fletcher-Powell procedure, depending on the user's 
request. When input to CLASSIFY, classification is performed 
using the linear transformation. When input to SCTRPL, the 
dimension of the data from the MSS data file is reduced to two 
linear combinations. The DATATR processor uses the matrix to 
create a new image file with the reduced dimensionality. The 
TRSTAT processor creates on SAVTAP a new file containing the 
transformed statistics. 

The keyword B-MATRIX on a control card indicates that the 
B-matrix is being input. Since the matrix may be input on cards 


or from a disk file, the parameter CARDS or FIliE must be speci- 
fied on the same card in columns 11 through 72. The entire file 
is defined below by card types . 

• Card type 1 — The keyword B-MATRIX in columns 1 through 10 and 
CARDS or PILE in columns 11 through 72 start the input of the 
file. 

o Card type 2 — One card of this type . 


Columns Format 


Definition 


6-7 12 Number of linear combinations 


13-14 12 Number of channels 

18-80 3012 The remainder of this card lists by 

number the channels for which the matrix 
was computed (e.g., columns 18 through 
19, first channel, etc.), for a ma.\imum 
of 30 channels right justified in the 
field . 


• Card type 3 — The number of these cards is determined by the 
size of the matrix. The values are input by column as indi- 
cated below, five values per card. 


B(k,n) , k = linear combinations; n « channels 


1 

(k 

+ 

1) 

• • [nk - 

(k - 

1)] 

2 

(k 

+ 

2) 

• • • [nk - 

(k - 

2)1 

3 

{k 

+ 

3) 

• • • [ nk - 

(k - 

3)] 


. k 2k nk 
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Columns 

Format 




Definition 

6-20 

E15.8 

Element 

1 

of 

matrix 

21-35 

E15 .8 

Element 

2 

of 

matrix 

36-50 

E15.8 

Element 

3 

of 

matrix 

51-65 

E15 .8 

Element 

4 

of 

matrix 

66-80 

E15.8 

Element 

5 

of 

matrix 

• 


(Continued 

i on next card) 


3 . 2 . 4 . 3 Cluster Means File 

The cluster means file is an optional input to the clustering 
processor ISOCLS^ It may be used to begin the clustering process 
by estimating cluster centers (means) . The means can be taken 
from the module STAT file (see section 3. 2. 4.1) created by 
TRSTAT, STAT, ISOCLS , or the user. Means may be input for up to 
30 channels for each cluster center, and a subset of the channels 
to be used may be indicated on the CHANNELS control card . 

The keyword MEANS in the control cards for ISOCLS indicates 
initial cluster means are being input. Since the means may be 
input on cards or from a disk file, the parameter CARDS or FILE 
must be specified on the same card in columns 11 through 72. If 
on cards, CARDS starts the input of the cluster means deck, which 
must immediately follow. The format for the entire file is 
indicated below. 

• Card type 1 _ Control card keyword MEANS is left justified in 
columns 1 through 5. The parameter CARDS in columns 11 
through 72 starts the input of the card deck. 

* Card type 2 — Number of clusters and channels. 


3-18 


Columns 

Format 

Definition 


a% 

1 

»— 

o 

15 Number o‘ 

initial clusters for 

which 


means are 

provided 


25-30 

15 Number of 

channels for which means are 


provided 



Card type 

3 — Actual channels 

used in computation 

of means 


Columns 

6-7 

Format 

12 

Channel 

1 

Definition 

CO 

1 

yo 

12 

Channel 

2 


10-11 

• 

12 

• 

Channel 

• 

3 


• 

64-65 

• 

12 

• 

Channel 

30 



Card type 4 — Mean vectors for the initial clusters: These 

cards are in the same format as the mean cards (card type 10) 
in the module STAT file. The first mean for each cluster 
always begins on a new card. The number of cards depends on 
the number of channels and the number of clusters. Five 
values are placed on each card. 

Columns Format Definition 


6-20 

E15 .8 

Mean 

for 

channel 

1 

21-35 

E15.8 

Mean 

for 

channel 

2 

36-50 

E15.8 

Mean 

for 

channel 

3 

51-65 

E15.8 

Mean 

for 

channel 

4 

66-80 

E15.8 

Mean 

for 

channel 

5 


(Continued on consecutive cards of the 
same format) 
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TABLE 3-1.- ANCILLARY CARDS DOR ALL PROCESSORS 


Keyword 

HEDl 


HED2 


DATE 


COMMENT 


Parameter and 
default values 

Any 60 characters 
beginning in column 11 
Default; LYNDON B. 
JOHNSON SPACE CENTER 

Any 60 characters 
beginning in column 11 
Default: HOUSTON, 

TEXAS 

Any 12 characters 
beginning in column 11 
Default; Current date 

Any 60 characters 
beginning in column 11 
Default: No comments 

printed 


Function 

Replaces first header line 
with the indicated char- 
acters in the parameter 
field . 

Replaces second header line 
with indicated characters 
in the parameter field. 

Prints the indicated 12 
characters in the right 
corner of the heading in 
place of the current date. 

Prints a comment line using 
the 60 characters found in 
the parameter field. 


TABLE 

3-2.- 

FIELDS IN 

THE PROCESSORS OF 

EOD-LARSYS 

Proaeaaor 

£ l«Hs 

Xlnda of 
flelda 


p«rmite4tJ 

HIST 

Hequtred 

Areaa to be 
hiatogranmed 

•END 

Field cards 
SEND 



CRAVMAP 

Required 

Aieaa w be 
dtaplayiid aa 
gray-icalt 
mapa 

•ENn 

Field cards 
SEND 



STAT 

Required 

Training 

fielda 

•END 
CMO0 
SUHCUSS 
Field cards 
CUOS (etc.) 
SEND 


* 

■Msocts 

Required 

Training 

flelda 

•END 

CUSS 

Field cards 
CLASS lets.) 
SEND 

^DESIGNATE 
OTOER or 
oesignate 

GNtOR 

Field cards 
SEND 



None 






Required 

Areas to bo 
claaalCled 

■END 

Field cards 
SEND 



f)l3PUV 

Optional 
automatic 
dlaptay 
of claa- 
aif lel 
fie Ida 

*^Teat fields 
or dealgnated 
flelda 

>^*END 

CLASS 

Field cards 
CUSS (etc.} 
SEND 

«'END 
SEdCLASS 
Field carJa 
St’DCUSS letc 
SEND 

•EKO 

DESIGNATE 
Pt‘Ud cards 
.) 'JEStGNATE I’NIGE 

Plsid cards 
SEND 

DATATR 

Required 

Areas to be 
tranalormed 

•END 

Fluid cards 
SEND 



THSTAT 

None 





NDHIST 

Required 

Araaa to be 
hlatogramned 

OPTION SUaCLS 

•END 

CLASS 

St'BCUSS 

Field cards 

SURCUSS (etc.) 

SEND 

OPTION CUSS 

•END 

CUSS 

Field carlo 
CUSS letc.l 
•END 

•END 

Finlii card? 
SEND 

SCTftFt* 

None 





iXJtnATA 

Required 

Sota are 
treated as 
point tiolda 

•END 
TYPE 1 
SW8S 

Fluid cards 
CLASS letc.l 
Type 3 
CUSS 

Field cards 
CUSS Ucc.l 
SEND 

-•END 
'lacie- 
formalted 
dot cards 
SEND 


UBEt. 

Optional 

Areaa of the 
unconditional 
cluster map 
If a pcocedure 
la selected 

•END 

Field cards 
SEND 



OAHRC 

Only one 

field 

required 

unleaa 

malting 

a moaalc 

Rectangular 
fields only 

•END 

Field card# 
SEND 




“ISOCLS 9en«rat«5 clu«c«r9, vhlch are aubclaeaee. 

^Ceal^naeed other or dealgnated unldentlClable> 

’’Can include both> 

‘^Thia type o£ tletd dealt can be uaod profitably If atatlatlca were generated by STAT or tsncts. 
*Thla dealt ahould be uaed only If atatlatlca were generated by STAT. 

^lAClE la the acronyo for the Urge Area Crop Inventory Experiment, conducted at ,ISC 
from 1575 through 1978. 
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4 . PILES 


The files described in this section are used internally by the 
system to pass information between processors. It is the user's 
responsibility to assign the necessary files for his or her par- 
ticular job. In the discussion that follows, the names of the 
units on which the files are written are also used to identify 
the files. 

4.1 STATISTICS FILE (SAVTAP, UWIT 20) 

The SAVTAP file must be assigned either to disk or to tape, nor- 
mally the former, whenever one or more of the processors STAT, 
ISOCLS, SELECT, CLASSIFY, DATATR, TRSTAT, NDHIST, SCTRPL, or 
LABEL are executed. One file is written on unit 20 for each exe- 
cution of STAT, TRSTAT, or ISOCLS or for input of a module STAT 
file bo some other processor. The file contains the same infor- 
mation as itemized in section 3. 1.4.1 for the module STAT file. 

Multiple files may be written on a single unit, usually disk, and 
may be accessed by using the STATFILE control card. This control 
card communicates the file number for positioning the unit and 
the logical unit assignment. The first file is always assumed 
unless otherwise specified by the user, and the unit assignment 
assumes Fortran unit 20 unless otherwise specified by the 
STATFILE control card . In executing several processors consecu- 
tively and referencing the same file, only one STATFILE control 
card need be submitted. If different files are to be referenced 
during one execution, then the file number may be changed from 
one processor to the next by input of the STATFILE control card 
to each processor. For example, 

$STAT 

STATFILE UNIT=20 ,FILE=2 
(Other control cards) 
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*END 

(Class I subclass, and field definitions) 

$END 

$CLASSIPY 

*END 

(Fields to be classified) 

$END 

The STAT processor will write the training statistics for this 
run on file 2 of the SAVTAP file (unit 20). (The system files, 
their logical units, and assignments are set out in table 4-1.) 
CtiASSIPY will use all of the statistics on file 2 of the tape for 
classification . 

The following example hows assignments for back-to-back execu- 
tion of STAT, I30CLS, and SELECT. 

$STAT 

STATPILE UNIT=20,FILE=2 
(Other control cards) 

*END 

(Class, subclass, and field definitions) 

$END 

$ISOCLS 

STATPILE UNIT=20,PILE=3 
(Other control cards) 

*END 

(Class and field definitions) 

$END 

$SELBCT 

STATPILE UNIT=20,FILE=2 

BEST 4 

*END 

$END 


STAT will write on file 2 of unit 20, ISOCLS will write on file 3 
of the same unit, and SELECT will go back to file 2 of unit 20 
for the statistics computed by STAT. 

4 .2 B-MATRIX FILE (BMFILE, UNIT 10) 

The file written to the BMFILE unit contains the transformation 
matrix which corresponds to the B-matrix file (section 3. 2, 4. 2). 
The file is an optional input to SELECT, CLASSIFY, and SCTRPL and 
a required input to DATATR and TRSTAT. When the card deck or 
image file is input to any of these processors, this file is 
automatically written. The B-matrix is computed by the SELECT 
processor and is automatically output to the file when the 
Davidon-Pletcher-Powell procedure is executed. 

4 .3 ONE-DIMENSIONAL HISTOGRAM FILE (HISFIL, UNIT 13) 

On logical unit 13, ‘the HIST processor creates the HISFIL, which 
is used by the GRAYMAP processor . 

4 . 4 CLASSIFICATION MAP FILE (MAPTAP, UNIT 2) 

The MAPTAP file (appendix D) , which is output by CLASSIFY, con- 
tains the statistics actually used in the classification, the 
training field information, and all of the classification 
results . 

4.5 N-DIMENSIONAL HISTOGRAM FILE (NHSTUN, UNIT 4) 

The NDHIST processor writes a file to the NHSTUN to be used as an 
interface to the SCTRPL processor. The default assignment is 
unit 4, but the user may assign any available unit. The NHSTUN 
file format is defined in appendix E. In earlier documentation 
of EOD-LARSYS, the file written on NHSTUN, unit 4, is referred to 
as the NDIM file. 


4.6 TRANSFORMED STATISTICS FILE (SAVTAP/ UNIT 20) 


The TRSTAT procesaoE' writes the transformed statistics on the 
SAVTAP file. (See section 4.1 for further information . ) 

4 . 7 DOT DATA FILE (DOTONT/ UNIT 19) 

The DOTDATA processor writes unformatted files on the DOTUNT. 

^ The files contain information extracted from the MSS data file, 
using all or a subset of 209 possible grid points (dots) . The 
files created on the DOTUNT are used in processors ISOCLS, 
DISPLAY, and LABEL. The format of the dot data file is defined 
in appendix P. 


TABLE 4-1.- DEFAULT FILE ASSIGNMENTS 


Fortran unit 


EOD-LARSYS file 

2 

MAPTAP 

(classification map) 

4 

NHSTUN 

( n-dimensional histogram) 

6 

PRTUNT 

(printer results) 

9 

SAVTAP 

(output from TRSTAT) 

10 

BMFILE (transformation matrix if on 
separate file) 

11 

DATAPE 

(MSS data tape) 

12 

SCTRUN 

(scatter plots) 

13 

HISFIL 

(one-dimensional histogram) 

14 

TRFORM 

(transformed MSS data) 

16 

MAPUNT 

ISOCLS 

map) 

(mixed or conditional cluster map, 
cluster map, or final classif icati* 

19 

DOTUNT 

(dot data) 

20 

SAVTAP 

(statistics ) 

21 

CRDUNT 

(control card images) 

22 

RAN DIO 
pixel 

(direct access file for 
storage) 

23 

GTRWU 

( LACIE-formatted dot card images) 

None 

GTRDU 

format 

(ground truth images — Universal 
) 

NOTE; Unit 16 

is fixed at this time. 
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5 . OUTPUT 


5.1 CLUSTER MAP FILE (MAPUNT, UNIT 16) 

On logical unit 16, the DISPLAY processor optionally outputs a 
multifile data tape (MAPUNT) containing the subclass number to 
which each pixel was assigned during classification by CLASSIFY. 
Also on logical unit 16, the ISOCLS processor outputs a file 
containing either the cluster number (OPTION CLUSTER control 
card) or the mean vector to which each pixel was assigned during 
clustering. A key containing the color code for each cluster is 
given for the mean vectors. The color codes may be ordered 
according to the cluster number or to greenness (OPTION ORDER 
control card). (See section 9.5.3, table 9-1, for ISOCLS control 
cards . ) 

The results of the classification/clustering may be displayed on 
a suitable display device. The necessary tape must be mounted on 
a nine-track tape drive compatible with the device and may be 
output in either , LARS YS 11/111 or Universal format. The display 
may be made without color keys (appendixes B and C) or with color 
keys (see appendix G for tape format). To exercise this option, 
see FORMAT control card (table 9-1) for the ISOCLS processor and 
section 12 (table 12-1) for the DISPLAY processor.* 

One file is written on the output tape for each field classified 
or clustered. In earlier documentation of EOD-LARSYS, the file 
written to the MAPUNT is referred to as MAPFIL. 


*These data are available as input to NDHIST via seven- or nine- 
track tape or disk. 


5.2 SCATTER PLOT DATA FILE (SCTRUN, UNIT 12) 


The SCTRPL processor outputs two-axis color-coded spectral plots 
on a multifile Universal-formatted tape. The default assignment 
is unit 12, but the user may assign any available unit. (See 
file assignment chart, table 4-1.) The relevant tape format is 
defined in appendix H. In earlier documentation of EOD-LARSYS, 
the file written to the SCTRUN is referred to as PLOTAP . 

5.3' TRANSFORMED DATA FILE (TRFORM, UNIT 14) 

The DATATR processor outputs a multifile image tape of trans- 
formed data. The image file may be produced in either LARSYS II/ 
III or Universal format, defined in appendixes B and C, respec- 
tively. The output is usually assigned to logical unit 14. 

5.4 MERGED MSS DATA FILE (DATAPE, UNIT 11) 

The DAMRG processor outputs a merged image composed from up to 
six input images. Merging may be by channel, spatial relation, 
or user-chosen lines. 

5 • 5 LACIE-FORMATTED DOT FILES (GTRWU, UNIT 23) 

The GTTCN and GTDDM processors produce labeled dots on the basis 
of ground truth input. 


Table 5-1 summarizes the input and output of EOD-LARSYS files . 


TABLE 5-1.- OVERVIEW OF EOD-LARSYS INPUT/OUTPUT 


Processor 

Possible Inputs 

Output 

HIST 

DATAPE 
Field cards 

HISFIL 

GRAYMAP 

DATAPE 
HISFIL 
Field cards 


STAT 

DATAPE 
Field cards 

SAVTAP 

r.socc,s 

( TESTS P) 

DATAPE 
BMFILE 
SAVTAP 
DOTUNT 
Field cards 

SAVTAP 

MAPUNT 

SUliBCT 

SAVTAP 

BMFILE 

Best channels through 
common bloclt INFORM 
BMFILE 

CLASSIFY 

DATAPE 
BMFILE 
SAVTAP 
Field cards 

MAPTAP 

DISPLAY 

DATAPE 

DOTUNT 

MAPTAP 

Field card images — 
^DO/DU or test fields 

MAPUNT 

DATATR 

DATAPE 
BMFILE 
Field cards 

TRFQRM 

TRSTAT 

SAVTAP 

BMFILE 

SAVTAP 

NDHIST 

DATAPE 
SAVTAP 
MAPUNT 
Field cards 

NHSTUN (histogrammed 
by class, subclass, 
or field) 

SCTRPL 

NHSTUN 

SAVTAP 

BMFILE 

SCTRUN 

DOTDATA 

DATAPE 

Field card images for dots 
LACIE-formatted dot card 
images 

DOTUNT 

LABEL 

SAVTAP 

DOTUNT 

MAPUNT 

Field cards, all-of-a- 
Icind option 

MAPUNT (conditional or mixed 
cluster map for DISPLAY) 
MAPTAP 
SAVTAP 
DOTUNT 

DAMRG 

MSS data file 

MSS data file 

GTDDM 

MAPUNT 

LACIE-formatted 
dot labels 

GTTCN 

Ground truth Images 

MAPUNT 


^Designated other (DO) or designated unidentifiable (DU). 
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6. ONE-DIMENSIONAL HISTOGRAM PROCESSOR — HIST 


The processor HIST computes individual field histograms and a 
total histogram for all the fields and channels defined by the 
user. An individual statistics report is printed for every field 
histogrammed . The report contains a field description and the 
data range, mean, standard deviation, and normalized range (mean 
±3 standard deviations) for that field. 

A cumulative histogram of all the fields is calculated and 
written on an internal file to be read later by the GRAYMAP proc- 
essor. As for the field histograms, a statistics report is 
printed for the combined fields. 

The input DISPLAY control card allows the user to obtain a line- 
printer plot of the histograms. A histogram for each channel on 
the DISPLAY card (described in table 6-1) is displayed for each 
field, along with a cumulative histogram for all the fields. 

6.1 INPUT FILES 

An MSS data file (DATAPE) must be input. The assignment defaults 
to logical unit 11; but, by input of the DATA control card, the 
user may assign any available logical unit. (See table 4-1 for 
file assignments and section 3.1, Image Tapes, for further infor- 
mation on format.) 

6.2 OUTPUT FILES 

The HIST processor writes a file for the GRAYMAP processor on 
logical unit 13. This file (HISFIL) contains the histogram data 
for each channel requested . 


6.3 SCRATCH FILES 

The HIST processor does not require an additional scratch file. 
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6.4 CARD INPUT 

The forma ‘uS for all system card input are defined in section 3.2. 

6.4.1 PROCESSOR CARD 

The processor keyword is left justified starting in column 1, 
thus , 

$HIST 

This card directs the system monitor routine to select the HIST 
processor and causes all the routines used by the HIST processor 
to be loaded into the system. 

6.4.2 SPECIAL SYSTEM FILES 

The HIST processor does not use any special input files. 

6.4.3 CONTROL CARDS 

Control cards allow the user to input various options. These 
cards are identified by a keyword left justified in columns 1 
through 10 of the card, with the parameter values of additional 
keywords in columns 11 through 72 (beginning in any column after 
column 10) . These control cards may be in any order, but they 
must be the first cards after the processor card §HIST. 

Table 6-1 lists all available options, along with their default 
values . 

6.4.4 FIELD DEFINITIONS 

Fields to be histogrammed are input immediately following the 
*END control card. The card column format for field definitions 
is given in section 3.2.2. Input of field definition cards is 
terminated by the $END control card . 


6.5 CARD OUTPUT 


This processor does not output any card files. 

6.6 RESTRICTIONS 

a. The maximum number of channels is 30. 

b. The number of histograms requested to be plotted may be 
limited if internal dimensions are too small for all user 
requests. (For example, if the user requests 30 channels to 
be histogrammed , only 14 of those histograms may be plotted; 
however, all 30 will be histogrammed.) 

This limitation is a function of the number of channels 
requested on the CHANNELS control card. If too many channels 
are indicated on the DISPLAY control card, a diagnostic is 
printed but execution continues. 

c. The channels on the DISPLAY card must be subset of the 
channels on the CHANNELS card . 

d . The data for all channels for one scan line are unpacked into 
an array dimensioned 12 000 . If the number of channels times 
[(sample end - sample begin)/sample increment] exceeds 

12 000, a diagnostic message is printed. Sample end is reset 
to fit the dimensions, and execution continues. 

6.7 DIAGNOSTIC MESSAGES 

The diagnostic messages and the subroutines in which they appear 

are listed in appendix I. 
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TABLE 6-1.- CONTROL CARDS FOR HIST 


Keyword (a) 

Parameter and 
default values (b) 


Function 


Required 

cards 


CHANNELS 

C^,C2, • • • /C)^ 
k < 30 

Channels 

Ci,C2, • • 
integer 
commas . 

to be histogrammed , 
•,Cj^, should be 
numbers separated by 

*END 

Blank 

Signals 

control 

the end of the 
cards . 

$END 

Blank 

Signals the end of all card 
input for this processor. 


Optional 

cards 


DATA 

UNIT=n,FILE=m 
Default; n=ll,m=l 

n is the 
Fortran 

number of the 
logical unit to 


Which the MSS data tape 
(DATAPE) has been assigned; 
m-1 is the number of files 
to be skipped on the unit. 
For back-to-back execution 
of more than one processor, 
if using the same file num- 
ber, only one DATA control 
card need be submitted . 


^The keyword must be left justified in card columns 1 through 10. 

^The parameter values are in card columns 11 through 72 (beginning 
in any column past 10) . 
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TABLE 6-1.- Concluded. 


Keyword 

SIZE 


SIZE 


SIZE 


DISPLAY 


Parameter and 
default values 

XHIGH=K 
0 < K < 255 
Default; XHIGH=255 


XLOW=J 

0 < J < XKIGH 
Default; XLOW=0 


YSIZ=L 
0 < L < 

Default: YSIZ-15 


Function 

K is an integer which sets 
the ma'-'imura radiance value 
which will be histogrammed . 
XHIGH becomes x^^ax 
x-axis of the histogram 
plot 

j is an integer which sets 
the minimum radiance value 
which will be histogrammed. 
XLOW becomes on the 

x-axis of the histogram 
plot.° 

L is an integer which sets 
the height of the y-axis 
{number of print lines) . 
Using the input YSIZ, the 
y-axis scale for the histo- 
gram plot will be determined 
by the processor to be 
f(x)^ax ( YSIZ-D/YSIZ 
[f(x)j^ax denotes the largest 
count in the histogram] . 


k < 30 

Default: No plots 


Channels for which histo- 
grams will be plotted . 

^l'^2'*‘*'^k subset 

of the CHANNELS card . 


Ancillary cards 

HEDl, HED2, DATE, COMMENT (see table 3-1) 


*^The difference between XHIGH and XLOW must be at least 100, 
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7 , GRAY MAP PROCESSOR — GRAYMAP 


The chief purpose of GRAYMAP is to produce alphanumeric pictorial 
printouts of digitized MSS data. Each data sample is eight bits, 
providing 256 possible gray levels for each MSS data channel. To 
allow a meaningful distinction in gray-scale tones, GRAYMAP 
assigns each of the 256 levels to 1 of as many as 16 possible 
symbols. These symbols may be preassigned or arbitrarily 
assigned for each run. The specifications for the bin edges for 
each symbol may be assigned arbitrarily by the user for each run 
or computed from the histogram data in order to result in equal 
activity for each of the symbols. In any case, the data are sub- 
sequently output in te'rms of symbols, and each symbol represents 
a range of data values in which the corresponding data points 
fall . 


7.1 INPUT FILES 

An MSS data file must be input to the GRAYMAP processor. The 
assignment defaults to logical unit 11; however, by input of the 
DATA control card, the user may assign any available logical 
unit. (See table 4-1 for file assignments and section 3.1, Image 
Tapes, for further information on format.) 

The GRAYMAP processor requires the bin levels to be input on a 
control card or computed from the histograms output by the HIST 
processor on the HISPIL. When the bin levels are to be computed, 
logical unit 13 may be assigned to either disk or tape or allowed 
to default to disk (no assignment) . If the HIST processor has 
not been executed before running GRAYMAP and bin levels have not 
been input, a default histogram of every 10th line for 500 lines 
and every 10th sample for 200 samples is computed, and HISPIL is 
created on logical unit 13. 


/ 


4 - 


7-1 


Figure 7~1. shows the interaction of the HIST and GRAYMAP 
processors . 

7.2 OUTPUT FILES 

No files are output by the GRAYMAP processor. 

7.3 SCRATCH FILES 

The GRAYMAP processor does not require additional scratch files. 

7.4 CARD INPUT 

All system card input formats referred to in this section are 
defined in section 3.2. 

7.4.1 PROCESSOR CARD 

The processor keyword , is left justified starting in column 1, 
thus , 

$ GRAYMAP 

This card directs the system monitor routine to select the 
GRAYMAP processor and initiates loading of routines used by 
GRAYMAP . 

7.4.2 SPECIAL SYSTEM FILES 

None of the special system files are required for this processor. 


7.4.3 CONTROL CARDS 

Table 7-1 lists all available options and control cards recog- 
nized by GRAYMAP, along with their default values. 


7.4,4 FIELD DEFINITIONS 


Fields for which gray-scale maps are desired must follow the *END 
control card. See section 3.2.3 for the format of field defini- 
tion cards. Field definition input is terminated by the SEND 
control card . 

i 

' 7.5 CARD OUTPUT 

The GRAYMAP processor produces no card output. 

7 . 6 RESTRICTIONS 

The system-related restrictions in section 24 apply to this 
processor . 

The maximum number of channels allowed is 30, and the maximum 
number of bin levels is 16. 

7*7 DIAGNOSTIC MESSAGES 

The diagnostic messages for this processor are listed by sub- 
routine in appendix I. 


CABLE 7-X.- CONTROL CARDS FOR GRAYMAP 


Parameter and 
default values (b) 


Function 


*END 


$END 


Blank 


Blank 


Signals the end of the 
control cards. 

Signals the end of all card 
input for this processor. 


DATA 


CHANNELS 


UNIT=n,FILE=m 
Default: n=ll,m=l 


^1 '*^2 ' * ■ * '^k 
k < 30 

Default: Graymap 

for all channels on 
HISFIL (created by a 
previous execution 
of HIST) 


n is the number of the 
Fortran logical unit to 
which the image data cape 
has been assigned; m-1 is 
the number of files to be 
skipped on the unit. For 
back-to-back execution of 
more than one processor, if 
using the same file number, 
only one DATA control card 
need be submitted . 

Provides pictorial printout 
for requested channels. 


The keyword must be left justified in card columns 1 through 10. 

The parameter values are in card columns 11 through 72 (beginning 
in any column past 10) . 




TABLE 7-1.- included. 


Keyword 

Parameter and 
default values 

Function 

BINLEVEL 

Ni,N 2 ,“ 

Upper bin edges for gray- 


k < 16 

scale levels with a range of 


Defaults Histograms 

0 to 255 and a maximum of 16 


used to set bin 

levels; the last bin level 


levels 

should always be 255. 

SYMBOLS 

,82 , • • * ,Sj^ 

Set of characters separated 


k < 16 

by commas, with a maximum of 


Default: Tv/o sets 

16 symbols per SYMBOLS card . 


of 10 symbols over- 

If two sets are input, the 


printed, resulting 

second overprints the first. 


in one of 

The number of symbols input 


$,X,0,O,*,=, ,b 

on one card determines the 
number of bin levels when 
using the histograms to set 
the levels . Blank is a 
legitimate character. 


Ancillary cards 

HEDl, HED2, DATE, COMMENT (see table 3-1) 



i 

Figure 7-1. ~ Functional diagram showing interaction of the 

HIST and GRAYMAP processors. 










8 . STATISTICS PROCESSOR _ STAT 


The statistics processor, STAT, computes the multichannel mean, 
standard deviation, covariance matrix, and correlation coeffi- 
cient for each training field and each training subclass defined 
through user input. In addition, at the user's option, histo- 
grams and spectral plots may be computed for fields and 
subclasses . 


The STAT processor requires user input of both card images and an 
MSS data file. Card image input consists of an optional number 
of cards from the set of control cards defined in table 8-1 and 
the training field definitions described in section 3.2.3. The 
required input MSS data must encompass the areas specified by the 
training field definitions. The processor is activated by a spe- 
cific processor card defined in section 8.4.1. Optional func- 
tions are directed by means of the input control cards or the 
built-in default for any control card that is not input. 


In addition to the optional printouts under the direction of the 
control cards, the STAT processor creates the output file SAVTAP, 
which contains the computed statistics (mean vector and covari- 
ance matrix) for each training subclass. The training subclass 
statistics optionally may be output on punched cards (the module 
STAT deck) . Both the output statistics file SAVTAP and the out- 
put module STAT file are in a format acceptable as input to other 
processors in EOD-LARSYS . Figure 8-1 gives the functional flow 
of the STAT processor . 


The mean vector for the subclass is computed as follows: 







( 8 - 1 ) 
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where 


1 ''i 

X . = ^ X . = average value in channel p for subclass i 

pi P] 

p = channel number 

P = largest channel number 

Nj_ = number of samples in all training fields for subclass i 

Xpj = the sample of the MSS data for channel p (a value 

between 0 and 255) 


The covariance matrix for the i*-*^ subclass is computed as 
follows : 

fmmm 

• • • k. 


^1 = 


^11 i ’^^lai 


^‘21i ^22i 


"Pli 


pqi 


'IPi 


^PPi 


where 


Ni 


T] X X 

4 ^ n r 


«i 


^i 


pqi Nj_ - 1 “p“q 


E i; X, 


p r 


= channel number 


Closely related statistics are the standard deviation and corre- 
lation coefficient for the i^^ subclass, which are computed as 
follows : 

1/2 


pi 




pqi 


(8-3) 


pqi V 072 

^^ppi^qqi^ 
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n\ 


where 


*^pi 

Ppqi 


standard deviation in channel p for subclass i; p = q 

correlation coefficient between channels p and q for 
subclass i 


knni = element of the covariance matrix for subclass i; the 
variance between channels p and q 


8 .1 INPUT FILES 

An MSS data file must be input to the STAT processor. The 
assignment defaults to logical unit 11? however, by input of the 
DATA control card, the user may assign any available logical 
unit. (See table 4-1 for file assignments and section 3.1, Image 
Tapes, for further information on format.) 

8 .2 OUTPUT FILES 

The STAT processor always outputs the statistics on the SAVTAP 
file and, optionally (by means of the OPTION PUNCH control card) , 
provides the module STAT file on cards. (See section 3. 2. 4.1 for 
format of card file.) 

The required output file SAVTAP will contain the class names, 
subclass names, and the subclass statistics (mean vector and 
covariance matrix) computed by the STAT processor for every sub- 
class defined. The output statistics file must be assigned to 
either dis]< or tape. The assignment defaults to logical unit 20? 
however, by input of the STATFILE control card, the user may 
assign any available unit. (See table 4-1 for file assignments 
and table 8~1 for control card description.) 

If the STATFILE control card is used, the statistics from more 
than one execution of STAT may be saved on the same tape. 
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8.3 SCRATCH FILES 


The STAT processor does not require the use of a separate scratch 
file. 

8.4 CARD INPUT 

The specific card column formats for the information to be input 
on the processor and control cards are given in sections 3.2.1 
and 3.2.2. Table 8-1 describes the complete set of keywords and 
option parameters recognized and acted upon by the STAT processor 

If possible, each keyword and its option parameters are to be 
completely contained on one control card. However, if more 
parameters are required than can be contained on one card, the 
control card may be repeated and the parameters continued on the 
next control card . The parameters for a control card of a given 
type will be cumulative over all cards of that type . 

The control cards follow the $STAT processor card. All options 
available on the STAT processor have a default setting which is 
used by the processor for those option parameters not input via 
control card. The control card *END must be input to signify the 
end of the set of control cards. Immediately following the *END 
card, a set or sets of CLASS, SUBCLASS, and training field defi- 
nition cards must be input. See section 8.4.4 for further 
details on training field definitions. 

8.4.1 PROCESSOR CARD 

The processor keyword is left justified starting in column 1, 
thus , 

$STAT 

This card directs the system monitor routine to select the STAT 
processor and indicates the input of STAT processor control card 
images . 
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8.4.2 SPECIAL SYSTEM FILES 


The processor does not expect input of any of the system- 
generated files described in section 3.2.4. 

8.4.3 CONTROL CARDS 

Table 8-1 gives the complete set of control cards which the user 
may input to direct the STAT processor functions and the default 
functions performed by the processor. With the exception of the 
*END and $END control cards, the sequence of the control cards is 
optional. The *END card must immediately follow the last control 
card, if any; the CLASS, SUBCLASS, and training field definition 
cards must immediately follow the *END card; and the $END card 
must immediately follow the last card of the input training field 
definitions . 

8.4.4 CLASS, SUBCLASS, AND FIELD DEFINITIONS 

All CLASS, SUBCLASS, and field definition cards occur between the 
’*‘‘END and $END control cards . The formats for these cards are 
given in section 3.2.3. Training fields are grouped into statis- 
tically similar subclasses, and subclasses are further grouped 
into classes. 

A training class is defined to the processor by one card contain- 
ing the keyword CLASS in columns 1 through 10 . The user- 
determined alphanumeric name to be assigned to the class begins 
in column 11 and may contain a maximum of four characters 
(through column 14) . At least one CLASS card must be input. 

A CLASS card must be followed by at least one subclass grouping . 

A subclass grouping is on a SUBCLASS card followed immediately by 
one or more field definition cards. All fields defined by field 
definition cards following the SUBCLASS card will contribute a 
cumulative sample set from which the training subclass statistics 
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will be computed for the named subclass. The set of cards — on 
SUBCLASS card followed by one or more field definition cards _ 
generates the statistics for one training subclass . The number 
of training fields to be defined for one given subclass is not 
restricted. The following example shows the grouping of 
subclasses into classes . 


Classes 


Subclasses 


SSTAT 


(Control cards) 


$ENO 


CLASS 

SUBCLASS 


. (Fields) 


SUBCLASS 

. (Fields) 


CLASS 

SUBCLASS 


(Fields) 


CLASS 

SUBCLASS 


(Fields) 


SUBCLASS 

(Fields] 


SUBCLASS 


CLASSl 

SUB 11 (Of CLASSl) 


SUB 12 (Of CLASSl) 


A c c 0 

SUB 21 (of CLASS2) 


CLASS 3 

SUB 31 (of CLASS3) 


SUB 32 (of C1ASS3) 


SUB 33 (of CLASS3) 


6 


(Fields) 


8.5 CARD OUTPUT 


The STAT processor will optionally output on punched cards the 
module STAT file (section 3. 2. 4.1). The module STAT file con- 
tains the training field vertices, the subclass names, the sub- 
class numbers, the association of training fields with each 
subclass and class, and the computed statistics for each training 
subclass. 

The module STAT file is output by the processor on cards only 
when specified by user input of the OPTION PUNCH control card . 

8.6 RESTRICTIONS 

The system-related restrictions in section 24 apply to the STAT 
processor . 

In addition, a core storage limitation is associated with the 
total storage required by the training subclass statistics and 
the various options (i.e., producing histograms and spectral 
plots). The upper limit on core storage available for all 
requirements generated by the input to the STAT processor is 
10 600 locations. Each subclass covariance matrix requires 
approximately 1/2 (number of channels)^ locations; each subclass 
mean vector requires locations equal to the number of channels; 
and each training field requires seven locations. If a large 
number of subclasses, channels, and training fields in combina- 
tion with one or more of the options available by means of the 
OPTION control cards causes the core storage limits to be 
exceeded, the STAT processor prints a diagnostic message request- 
ing the user to decrease options, after which it halts (see 
section 8.7). 


The following formulas determine the maximum number of fields 
that can be input for a case without any histograms (eq. 8-4) and 
another case with subclass histograms (eq. 8-5) . 


NOFLD 


10 600 - 


5NOSPEC + 7MAXSUB + 


4 + 2MAXSD8 + 5 


32 


NOFEAT + 1) NOFEAT + 40 


(8-4) 


where 

NOSPEC = number of subclasses grouped together (maximum of 20) 
MAXSUB = maximum number of subclasses 
NOFEAT = number of channels 


NOFLD 


10 600 - 


5NOSPEC + 7MAXSUB + 


4 + 


2MAXS0B 

5 


+ 5 


NOFEAT + IJnOFEAT + 40 + XSI2(N0HIST + 1) 


ir 


(8-5) 

If fields and subclasses' need to be histogrammed , the term 
XSIZ(N0HIST -I- 1) should be added to the numerator of equation (8-4), 
where XSIZ = range of histogram (maximum of 101) and NOHIST = number 
of channels histogrammed . 


8 .7 DIAGNOSTIC MESSAGES 

The diagnostic messages provided by the STAT processor are listed 
in appendix I, along with the probable cause and remedy of the 
condition which prompted the message. During statistical com- 
putations, other messages also may be output by utility routines 
common to both STAT and other processors in EOD-LARSYS . See the 
system-related messages in appendix I for additional messages 
obtained from a STAT execution. 
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TABLE 8-1.- CONTROL CARDS FOR STAT 


Keyword (a) 


CHANNELS 


*END 


$END 


DATA 


Parameter and 
default values (b) 


Function 


Required cards 


^l'^2' ‘ * ’ 

1 < k < 30 

Default; k=30'; how- 
ever, unless the MSS 
data file (DATAPE) 
has exactly 30 chan- 
nels, the default 
must not be taken. 


N’s are the integer channel 
numbers used by the proc- 
essor in computing training 
subclass and training field 
statistics. The channel 
numbers must be from the set 
of channels available on the 
MSS DATAPE file. 


Blank 


Signals the end of the 
control cards . 


Blank Signals the end of all card 

input for this processor. 

Optional cards 

UNIT=n , FILE=m n is the number of the 

Default: n=ll,m=l Fortran logical unit to 

which the MSS data tape has 
been assigned? m-1 is the 
number of files to be 
skipped on the unit. For 
back-to-back execution of 
several processors, if the 
same file number is used, 
only one DATA control card 
need be input. 


^The keyword must be left justified in card columns 1 through 10. 

^The parameter values are in card columns 11 through 72 (beginning 
in any column past 10). 


TABLE 8-1.- Continued. 


Keyword 

OPTION 


HISTO 


Parameter and 
default values 

MAXSUB»N 

Default; MAXSUB=15 


Nj_ ,N2/ • ' • /N]^ 

1 < k < 30 
Default: k=30 


Function 

Informs the processor as to 
the maximum number of sub- 
classes which will be input. 
The parameter value is used 
for dimensioning purposes. 
This parameter must be set 
by the user if the number of 
subclasses he or she is 
about to define will exceed 
the default, It is advis- 
able to use this option when 
a large number of training 
fields are to be processed 
or when histograms have been 
requested . 

N’s are integer channel 
numbers for use in the 
histogram option. The 
channel numbers must be from 
the set designated on the 
CHANNELS control card . 

(NOTE; This control card 
does not initiate the 
histogram option.) 
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TABLE 8-1.“ Continued. 


Keyword 

OPTION 


OPTION 


OPTION 


SIZE 


Parameter and 

default values Function 


hist a histogram showing fre- 

Default; No histograms quency distribution of 

pixels (resolution ele- 
ments or radiance values) 
is printed out for every 
training field and every 
training subclass defined in 
the input training field 
definition dec)c. For each 
subclass (or field), a 
histogram is provided for 
every channel designated on 
' the HISTO control card . 


HIST=C a histogram printout is 

Default: No histograms provided for every training 

subclass defined in 
the input training field 
definition dec)< . 


HIST=F A histogram printout is 

Default; No histograms provided for every training 

field defined in the input 
training field definition 
deck . 


XHIGH=K 
0 < K < 255 
Default; XHIGH=220 


K is an integer which sets 
the maximum radiance value 


v;bich will be 
XHIGH becomes 
x-axis of the 
plot . 


histogrammed . 
^max 

histogram 
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TABLE 8-1, - Continued. 


K eyword 

SIZE 


SIZE 


SIZE 


OPTION 


Parameter and 
default values 

XLOW=L 

0 < L < HIGH 
Default: XLOW=120 


YSIZ=J 

0 < ^ ^(^^max 

Default: YSIZ-14 


Function 

L is an integer which sets 
the minimum radiance value 
which will be histogrammed . 
XLOW oecomes the ■ 

x-axis of the histogram 
plot . 

J is an integer which sets 
the number of increments on 
the y-axis of the histogram 
plot; therefore, it is the 
height (number of print 
lines) of the y-axis. Using 
the input YSIZ, the proc- 
essor will determine the 
y-axis scale for the histo- 
gram plot to be + 

( YSIZ-D/ysiZ . 


XSIZ=K Sets the range which will be 

Default; XHIGH - XLOW histogrammed; maximum range 

is 101. 


COVAR ■ The multichannel mean, 

Default: Statistics standard deviation, and 

are not printed. covariance matrix (lower 

triangular portion) are 
printed out for each train- 
ing subclass and training 
field defined in the input 
training field definition 
deck . 


TABLE 8-1. -- Continued. 


Keyword 

OPTION 


OPTION 


Parameter and 
default values 

COVAR=C 

Default; Statistics 
are not printed. 


COVAR-F 

Default: Statistics 

are not printed. 


Function 

The multichannel mean, 
standard deviation, and 
covariance matrix (lower 
triangular portion) ate 
printed out for each 
training subclass defined 
in the input training field 
definition declc . 

The multichannel mean, 
standard deviation, and 
covariance matrix (lower 
triangular portion) are 
printed out for e'ach 
training field defined in 
the input training field 
definition deck. 


OPTION 


NOCOVAR 


No training subclass or 
training field statistics 
are printed out. 


TABLE 8-1.“ Continued. 


Keyword 

SPECTRAL 


OPTION 


Parameter and 

default values Function 


^^2 '^3 '^4 
1 < < 30 

Default; 4 subclasses 
per spectral plot; 
subclasses 1 , 2 , 3, 
and 4 on the first 
plot; 5, 6, 7, and 8 
on the second plot; 
etc . 


M's are the integer numbers 
of up to four subclasses 
that are to be plotted on 
one single composite spec- 
tral plot . The subclass 
numbers must be obtained 
from the set of subclasses 
defined in the input train- 
ing field definition deck. 
Subclass 1 is the first 
subclass defined in the 
deck, and subsequent sub- 
class numbers are obtained 
by sequentially numbering 
the subclasses as they occur 
in the training field defi- 
nition deck. 


SPECTRAL A spectral plot is printed 

out for every training sub- 
class and training field 
defined in the input train- 
ing field definition deck. 
The plot consists of the 
subclass (or field) mean 
radiance value, mean stand- 
ard deviation, (a), and mean 
±3a plotted versus the chan- 
nel (spectral band) for 
every channel designated on 
the CHANNELS control card . 
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TABLE 8-1.- Continued. 


Keywocd 

OPTION 


OPTION 


SIZE 


STATFILE 


Parameter and 
default values 

SPECTRAL=C 


SPECTRAL=F 
Default; Spectral 
plots for subclasses 

SPECBAS=I 
0 < I < 105 
Default; SPECBAS-75 


UNIT=n,FILE=m 
Default; n=20,m=l 


Function 

A spectral plot will be 
printed out for every 
subclass defined in the 
input training field 
definition deck. 

A spectral plot will be 
printed out for every field 
defined in the input train- 
ing field definition deck. 

I is an integer which sets 
the minimum radiance value 
on the y-axis of the spec- 
tral plot (i.e., 
processor has a fixed y-axis 
increment (3) and a fixed 
number of y-axis values 
(50) . Using SPECBAS, the 
processor determines the 
y-axis range to be from 
ymin=SPECBAS to 
+150 . 

n is the number of the 
Fortran logical unit to 
which the SAVTAP file has 
been assigned; m-1 is the 
number of files to be 
skipped on the unit before 
writing SAVTAP. 
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TABLE 8-1.- Concluded. 


Parameter and 

Keyword default values 

OPTION PUNCH 

Default; The module 
STAT file is not 
punched , in which case 
statistics are output 
on the SAVTAP file 
only . 


Function 

The subclass mean vector and 
covariance matrix for every 
subclass defined by user 
input will be punched on 
cards in a format acceptable 
as input to other processors 
in the system. This punched 
card deck is called the 
module STAT file . 

cards 


Ancillary 

HEDlf HED2, DATE, COMMENT (see table 3~1) 
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9- ITERATIVE SELF-ORGANIZING CLUSTERING SYSTEM 
PROCESSOR _ ISOCLS 


A data set to be clustered by ISOCLS consists of spectral values 
from one or more user-specified fields in a certain class. With 
one entry into the ISOCLS processor, any number of classes may be 
defined and clustered as individual data sots. The user can 
deterr-ine the maximum number of clusters allowed per class by 
means of the CLUSTERS control card. However, the procedure may 
find fewer clusters than the maximum allowed. If the user plans 
to use the statistics generated from the clusters in later 
CLASSIFY or SELECT runs, he or she roust control the number of 
clusters. The SAVTAP file may contain statistics for up to 75 
clusters (or subclasses), but only 60 can be used for processing 
at any one time in CLASSIFY or SELECT. (Control cards are set 
out in table 9-1 . ) 

The clustering procedure used in ISOCLS (ref. 2) is an iterative 
procedure which assigns each MSS data srtmple to that cluster 
whose center is the nearest (in absolute distance) . At the end 
of each iteration (i.e., when every sample has been assigned to a 
cluster) , new cluster centers are defined by computing the mean 
vector for the data samples actually assigned to the cluster. 
After this initial split sequence, the iterative procedure con- 
tinues with a user-specified sequence of splits and combinations. 
See the SEQUEN control card . Using the STDMAX and DLMIN control 
cards, the user specifies criteria for splitting a cluster or 
combining clusters. 

After the final iteration, the covariance matrix for each cluster 
is computed and, at the user's option, is printed. All cluster 
statistics for the class are saved on the scratch file until all 
classes have been clustered, at which time the SAVTAP file is 
written. The chaining of clusters for the final map printout is 
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performed, if the user has requested this option (see CHAIN 
control card, table 9-1) . Statistics for the chained clusters 
are not computed. 

The KRN and MAP control cards allow users to control the amount 
of line-printer output they receive. A final map of the clus- 
tered data is always output along with a statistical summary of 
the clusters, which includes mean and standard deviation vectors , 
total points assigned to each cluster, and intercluster 
distances . 

The user may either input initial cluster centers to hasten the 
clustering process or allow the program to start the process by 
assigning all the data to one cluster, obtaining the mean and 
standard deviation, and then splitting ( unsupervised mode) . 
Initial means may be input (1) by cards ( see control card MEANS 
and cluster means deck, section 3. 2. 4. 3); (2) by the SAVTAP file 
( see control card STATFILE) ; or (3 ) in Procedure 1, from a dot 
file . Input of the initial means causes a scratch file to be 
written so that the means can be used repeatedly . Successive 
classes may or may not use the same means to establish cluster 
centers for a new class . The control card MEANS allovfs the user 
to request cluster centers from the last class to be read from 
the scratch file and used as initial centers for a new class . 
Input of a new set of initial means will cause the scratch file 
to be overwritten with new cluster centers. 

Several additions have been made in support of Procedure 1 
requirements . A general description of these additions follows. 

a. Optionally, starting dots (pixels) from the dot data file, or 
DOTUNT, may be used to begin clustering . 

b . The analyst may identify DO and DU pixel sets (fields) by 
field card input. The pixels in these fields are not 


included as inputs to the clustoring algorithm. They are 
assigned special cluster numbers and moan vectors fior display 
purposes , 

c. Using the Sun angle correction table, the pixel radiance 

values may be modified . (The correction table is built in . ) 
The radiance value modification applies only for clustering 
purposes. The user may input the Sun angles by cards or 
request that these angles be extracted from the header record 
of a Universal-format ted MSS data tape . 

The clustering algorithm in ISOCLS is detailed step by step in 
the following subsections. This entire procedure is repeated for 
each class (or data set) . 

See the functional flow chart for ISOCLS (fig. 9-1). 


9.1 PROCEDURES 


9.1.1 NOTATION 


Symbol 

Fortran 

name 

Definition 

CLDij 

CLD(I,J) 

Intercluster distance between clusters 



and j . 


DIST 

Distance from the data point k to the 
center of cluster i. 

DLMIN 

DLMIN 

Threshold value for combining clusters. 

ISTOP 

ISTOP 

Maximum number of initial split 
iterations . 

CHNTHS 

CHNTHS 

Chaining threshold value . 

LNCAT 

LNCAT or 

Number of existing clusters at a given 


INCAT 

time . 

N(i) 

N(I) 

Total number of data points assinged to 


cluster i. 
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Symbol 

Fortran 

name 

SEQUEN 

• SEQUEN 

NMIN 

NMIN 


PMIN 

PM IN 

NOSEQ 

NOSEQ 

ISEQ 

ISEQ 

NOFEAT 

NOPEAT 

STDMAX 

STDMAX 

Xk 

C(I,K) 

D 

MEANS (J, 

yii) 

AVP(J,I) 


AMN(J,I) 


STDEV(J,I) 


Definition 

Uaer-speeified soquonco of split and 
combine iterations . 

Minimum number of data points allowed 
per cluster both for the initial split 
iterations and for the first through 
(NOSEQ-l)*^^ SEQUEM iterations. 

Just before exiting ISOCLS^ clusters 
having fewer than PMIN+NOPEAT pixels are 
deleted . 

Maximum number of SEQUEN iterations. 

Number of SEQUEN iterations at a given 
time . 

Number of coordinates (channels) in a 
data vector. 

Threshold value for splitting clusters. 

Data vector Ic, C(I,K)- 
(Xj_,X2^ • • • /Xf^Qpgj^Yr^k 

Mean of the channel of the 
i*-^ cluster. 

Temporary summing variable for the cal- 
culation of the standard deviation of 
the channel of the i^^ cluster. 

Summing variable for computation of 
new means. After all data have been 
assigned to clusters on any one itera- 
tion, AMN(J,I) is the new mean of the 
j*-^ channel of the i*-^ cluster. 

Standard deviation of the channel 
of the i^^ cluster. 
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9.1.2 BSmBLISHING THRESHOLD VALUES 

Establish feheoshold v’-Jlues £o^ splitting clusb^ts (GTDMAX), com- 
bining clusters (0LM1R.‘, nnd deleting clustora (NMIN and PMIN) . 
Then begin the fiollowing iterative procedure. 

9.1.3 ITERATIVE PROCEDURE 

9 . 1 . 3 . 1 Classify and Calculate New Statistics 

Assign each data point to a cluster and at the same time collect 
the means, standard deviations, and point counts of the newly 
developing clusters. If there are no clusters, set i a i and go 
to iteration b . If clusters exist, begin with iteration a . 

a. Assign the data point Xj^ = * ’ * '•^NOFEAT^k 

cluster if d j^Xj^ ' ^ ^ ^ ^ ] 1 dj^Xj^, ^ ^ ] for all j ^ i, where 

d[xj^,p ^ defined as 




(ii] 

NO|^EAT 1 
j=l ' 

X - 

(9-1) 

b. 


N(i) = h(i) ■ 

f 1 

(9-2) 

c . 

h!*-> = 

, N(i) - 1 „(i) 
N(t) ‘‘j 

+ nToT ^jk 

(9-3) 

d . 

_ 

j 

N(i) - 1 .. (i) 
N(i) 'j 

+ ^ x2 

N(i) ‘^jk 

(9-4) 

e . 

(i) i (i) 

3 1 3 

_ 

2 \l/2 

[•S“l 1 

; j = 1, NOPEAT 

(9-5) 


Return to step a and repeat iterations a through e until all data 
points have been classified . 
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9. 1.3. 2 Dele fee Cl us begs 

r©t* the initial split itoratiens and foe tho first through 
(NOSBQ-1) usor-specified SEQUEN iturations, dclota all eluotors 
that have fewer than NMIN members. For the user- 

specified iteration (last user-inE^ut sequence), delete all clus- 
ters that have fewer th5i,n FMIN members, h cluster is deleted 
simply by removing the statistics for that cluster and reducing 
tho number of clusters ( >eci£ied by ENCAT) accordingly. 

9. 1.3. 3 Test for Completion 

If this is not the last iteration, proceed to 9. 1.3. 4. If this 
is the last iteration and no clusters were dole- ed, the procedure 
is finished. If one or more clusters wore deleted for having 
less than PMIN members, go back to 9. 1.3.1 and reassign the data 
ho the clusters obtained from iteration (NOSEQ-1) . 

9. 1.3. 4 Determine Type of Iteration 

Determine whether this is to be a split iteration or a combine 
iteration and proceed to the appropriate step. 

The sequence of iterations will be as follows ; 

SSSS . CCSCSC 

ISTOP SEQUEN 

and/or 
PERCENT 

where 

t 

S = split iteration 
C - combine iteration 

The beginning sequence of split iterations is terminated either 
(1) when the percentage of stabilized clusters is greater than or 
equal to the user-input percentage (see PERCENT control card, 
table 9-1) or (2) when ISTOP iterations have been reached. After 
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that point, the type of iteration (split or eombino) and number 

of iterations (NOSEQ) are determined by the SEQOEtl parameter. 

% 

The initial split iterations are primarily intended for the auto- 
matic establishment of cluster centers in the event they are not 
input. The sequence is shortened considerably if initial cluster 
centers are input . 


9. 1.3. 5 Split Clusters 

A cluster is split along the channel (1) if the channel 
has the maximum standard deviation for the cluster, (2) if the 
standard deviation along the j channel is greater than the 
STDMAX threshold parameter, and (3) if the cluster has more than 
2(NMIN+1) data points. 


If conditions (1) through (3 ) are met, two new clusters are 
created and the parent cluster is deleted. A cluster is created 
merely by defining its centers (means ) for each channel . If the 
i^^ cluster is split in the channel, the two new clusters 


will have centers at 




‘2 


t M 


U) 


± a. 


Ji) 1 

' "MO FEAT. 


where 


o will normally be but can be a user-input constant (see SEP 

control card ) . On a given split iteration, if the maximum number 
of clusters (CLUSTERS) has riot been reached, all clusters having 
a standard deviation greater than the STDMAX parameter will be 
split. To ensure that the clusters with the largest standard 
deviations receive che highest priority for splitting, when 
2 X LNCAT is greater than CLUSTERS, the standard deviations are 
ordered along the channel in descending order. Return to 
9. 1.3.1 after splitting clusters. 
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9. 1.3. 6 Combine Clusters 


Two clusters are combined if the distance between them is less 
than the DbMIN threshold parameter. The distance between clus- 
ters i and j is calculated as 


CLD. . = 
ID 


NOFEAT 

. 5 . 




1/2 


K 




(9-6) 


If CLDij < DLMIN and CLDj_j = MIN(CLDij) for all i = 1,LNCAT and 
j = 1,LNCAT for all i ^ j, clusters i and j will be merged to 
form a new cluster L with means 




k = 1, NOFEAT 


(9-7) 


N(i) + NCj) 

The clusters i and j are deleted. The new cluster L is not con= 
sidered as a candidate for merging with any other cluster on the 
iteration in which it was formed. Return to 9. 1.3.1 after com- 
bining clusters. 


9.1.4 CHAINING 

A final optional step in the clustering procedure groups all 
clusters which have intercluster distances less than the chaining 
threshold (CHNTHS) to form one cluster. The chaining procedure 
was adopted because the minimum variance criterion used in the 
iterative procedure above tends to group the data into spherical 
.(or ellipsoidal) groupings with Gaussian distributions. This 
type of grouping is certainly a natural grouping and would quite 
often be completely satisfactory. However,, some natural group- 
ings of the data are odd shaped and cannot be approximated by 
Gaussian distributions. Two examples are given in figure 9-2. 


At the end of the sequence of split and combine iterations, 
groupings of the type in figure 9-2 are likely to be separated 
into subclusters as illustrated in figure 9-3. The chaining 
algorithm allows the user to group subclusters 1, 2, and 3 
(fig. 9-3) into one composite cluster; likewise, subclusters 4, 

5, 6, and 7 can be grouped together to form one cluster. 

The algorithm scans the intercluster distance table (CLD) and 
begins a chain with the first appearance of two clusters within a 
distance of CHNTHS units. Once a subcluster is in the chain, all 
clusters that are within CHNTHS units of the subcluster are added 
to the chain. See figure 9-4. 

The statistics (mean vector and covariance matrix) of a cluster 
resulting from chaining are not calculated by the program 
because, in many cases, the chained cluster cannot be represented 
by a Gaussian distribution. 

There are, of course, instances where one can safely combine 
those subclusters that are chained by the program into one com- 
posite (Gaussian) cluster. For example, subclusters 1, 2, and 3 
in figure 9-5 can judiciously be combined into one final cluster. 
This is indicated by the fact that, pairwise, these three sub- 
clusters are all close to each other. In this case, the follow- 
ing formulas (ref. 2) can be used iteratively to compute the 
composite statistics. 

Assuming that two clusters ( ,m 3 _ , ) and (n 2 ,m 2 ,C- 5 ) are to be 
considered as one cluster (n,m,C), where all n, m, and C are the 


numbers o£ points, the mean vectors, and the covariance matrices, 
respectively, and m*^ is the transpose of m then 



9.2 IISIPUT FILES 

An MSS data file must be input to the ISOCLS processor . The 
assignment defaults to Fortran unit 11; however, by input of the 
DATA control card , the user may assign any available logical 
unit . (See table 4-1 for file assignments and section 3.1, Image 
Tapes, for further information on format.) 

In support of procedure 1, the starting dot information from the 
DOTUNT file must be input to begin the cluster processing; i.e., 
furnish starting cluster centers. 

9.3 OUTPUT FILES 

Statistics are output by ISOCLS to the SAVTAP file (section 4.1). 
The file assignment defaults to logical unit 20; but, by input of 
the STATFILE control card, the user may assign any available 
logical unit. (See table 4-1 for file assignments and STATFILE 
control card, table 9-1, for further information.) 

A cluster map tape (MAPUNT) may be generated optionally for dis- 
playing the results of the clustering on a suitable display 
device. The FORMAT control card requests the option and names 
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the desired format of the tape. Logical unit 16 should be 
assigned to a nine-track tape drive when this option is exercised 
( see section 5.1). 

h printout of the cluster results consists of the following data 
items by class: cluster numbers and symbols; cluster mean vec- 

tors (by cV isnel) ; cluster standard deviations by channel; inter- 
cluster v'’’ S'' -I aces 5 number of pixels per cluster; number of 
clusters; -.tad cluster map by field. 

9.4 SCRATCH FILES 

The program dynamically assigns random access disk storage for 
scratch files . ISOCLS uses the disk storage for temporary stor- 
age of cluster statistics , the data to be clustered , and the 
classification of each pixel. 


9 .5 C ARD INPUT 

9.5.1 PROCESSOR CARD 

The processor keyword is left justified starting in column 1, 
thus , 

$ ISOCLS 

This card directs the monitor routine to call the ISOCLS proc- 
essor and causes all routines used by the ISOCLS processor to be 
loaded into the system . 

9.5.2 SYSTEM CARD FILES 

The processor will read a cluster means deck in the format 
defined in section 3. 2. 4. 3. The deck may be used to establish 
cluster centers for the clustering procedure. 

9.5.3 CONTROL CARDS 

Control cards allow the user to input various options . They are 
identified by a keyword that is left justified in columns 1 
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thi'Quqh 10 o£ the card, with parameter values or additiunal key- 
words in columns 11 through 72. These control cards may be in 
any order, but they must be the £irst cards after the processor 
card $ISOCLS. Table 9-1 lists all available options, along with 
their parameter values. 

9.5.4 ’class and FIB}LD DEB'INITIONS 

A CLASS card, followed by at least one field definition card, 
must immediately follow the *END control card. The formats for 
these cards are defined in section 3.2.3. 


The pixels from all fields for one class are extracted from the 
sequential MSS data file (tape or disk) and stored on a direct- 
access disk file. The data from all fields for one class are 
clustered as one data set. The statistics for all clusters in 


that class are saved on a scratch file, and the next class is 


clustered. When all classes have been clustered, the statistics 
are written on the SAVTAP file. The input for definition of 
classes and fields is explained below. 

*END 


Wheat clustered as 
one data set.’ 


Nonwheat clustered as 
one data set. 


, CLASS 
) FLD 1 
) PLD 2 
\ ELD 3 

I CLASS 
\ FLD 4 
( FLD 5 


WHT 


NWHT 


$END 


Note that actual names may not exceed four characters. 
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-- //. 


n 


iSOCtiS reGOvjniaes DO/DU fields. All the DO/I3U field cai*ds (for 
all classes) must be input before the fields to be clustered. 
These fields must immediately follow the *END card. The CLASS 
card follQ\^?s the last DO/DU field card. 


E-Kamples ; 

• If DO/DU fields are being defined; 


'*'END 

DESIGNATED 

OTHER 

DESIGNATED 

UN IDE 

CLASS 

WHTl 

SEND 


OTHER 

(1.1) ,(1,1) , (40,1) ,(40,20) , (1,20) 
UNIDENTIFIABLE 

(1.1) ,(5,7) ,(8,7) ,(8,10) ,(5,10) 

WHT 

(1.1) ,(1,1) ,(196,1) ,(196,117) ,(1,117) 


• If no DO/DU fields are being defined; 

>^END 

CLASS WHT 

WHTl (1,1) ,(1,1) ,(196,1) ,(196,117) ,(1,117) 

SEND 


9.6 CARD OUTPUT 

A module STAT file (see section 3. 2. 4.1) may be punched and used 
as an interface between ISOGLS and SELECT or CLASSIFY. This 
option is exercised via the OPTION PUNCH control card. (Normally, 
however, an unformatted statistics f.ile, SAVTAP, is written to 
disk for subsequent use.) 


9 .7 RESTRICTIONS 

The ISOCLS processor uses disk for a temporary scratch file. 
There are approximately 750 000 words of storage available on 
this file. The data to be clustered for one class are stored on 
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this file, along with other information. To compute the maximum 
number of pixels per class, use the following formula . 


Maximum 

pixels 


750 000 - 30 


i number of pumber of \ 

I classes \\ channels / 

number of channels 


/number of ^ 
\ channels 


180oj 


+ 1 


(9~9) 


The maximum number of clusters per class is 60, and the maximum 
number of channels is 30. The covariance matrices for all clus- 
ters in one class must be stored in core at one time. They are 
stored in an array dimensioned 11 500. The following formula may 
be used to see if enough storage is available for the 
covariances . 


11 500 > 



“ /number of 

number of 

number of channels •^ | 

clusters 

^channels \ 2 /__ 


(9-10) 


9 .8 DIAGNOSTIC MESSAGES 

Diagnostic messages for the ISOCLS processor are presented in 
appendix I. 


9-14 


TABLE 9-1.- CONTROL CARDS FOR ISOCLS 


Parameter and 

Keyword (a) default values (b) 

Required 

CHANNELS DATA=Ci , C 2 , • * * f Cj^ , 

STAT=Ai,A 2, • • • fA}^ 
k < number of chan- 
nels on SAVTAP < 30 


*END Blank 


Function 

cards 

C's are integer channel num- 
bers that (1) will be used 
in clustering and (2) refer 
to the MSS data file. A's 
are integer channel numbers 
that (1) will be the starting 
vectors (initial means) of 
clusters, (2) refer to the 
SAVTAP file, and (3) must be 
a subset of the channels on 
the SAVTAP file. The same 
channels must be used through- 
out one execution of ISOCLS. 

If a cluster means card file 
is input, the channels on the 
CHANNELS card must be a subset 
of the channels in the means 
card file. 

Signals the end of the control 
cards . 


®The keyword must be left justified in card columns 1 through 10. 

^The parameter values are in card columns 11 through 72 (beginning 
in any column past 10) . 
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TABLE 9-1 


Continued 


Keyword 

$END 


DATA 


CLASSES 

CLUSTERS 


Parameter and 

default values Function 

Blank Signals the end of all 

classes to be clustered for 
this set of control cards. 
The SETUP routine will be 
reentered to read new con- 
trol cards for the next 
class until all classes 
have been clustered. 


Optional cards 


UNIT=n,PILE=m 
Default: n-ll,ra=l 


N 

Default: 1 

N 

Default: 60 


n is the number of the For- 
tran logical unit to which 
the MSS data file has been 
assigned; m-1 is the number 
of files to be skipped on 
the unit. For back-to-back 
execution, if the same data 
file is to be processed 
throughout the execution, 
only one DATA card need 
be submitted. 

Number of classes to be 
clustered . 

Maximum number of clusters 
per class; N must be < 60. 


TABLE 9-1.- Continuo.d 


Keyword 

OPTION 


MEANS 


MEANS 


Parameter and 
default values 

CLUSTER 

Default: The output 

cluster MAPUNT file 
will contain the 
mean vector of the 
cluster to which the 
corresponding pixel 
was assigned. 

CARDS 

Default; Clustering 
procedure is auto- 
matically begun if 
this card or means 
file is nob input. 

PILE 

Default; Cluster 
centers are auto- 
matically established 
if this card or the 
means file is not 
input , 


Function 

The output cluster MAPUNT 
file will contain the clus- 
ter number to which the 
corresponding pixel was 
assigned . When selecting 
this option / the FORMAT 
control card must be input 
also . 

Initializes input of the 
cluster means deck. This 
deck is used to establish 
cluster centers for the 
clustering procedure . 


Indicates that means for 
initial clusters have been 
input previously from cards 
and stored on file . The 
same initial means are to 
be used again to repeat the 
process for a new data set . 


TABLE Si-l.- 


Continued . 


Keyword 

STATPILB 


SUBCLASSES 


MODULE 

ISTOP 


Parameter and 
default values 

INPUT/UNIT=n , PILE«m , 
OUTPUT/UNITwJi , FILER'S 
Default; No defaults 
for INPUT; ii=20,sal 
for OUTPUT 


Ci,C2, • • • 

k < 60 

Default; All sub- 
classes/clusters on 
SAVTAP file will be 
used in starting, the 
clustering . 


Blank 


N 

Default: 10 


Function 

n is the number of the For- 
tran logical unit to which 
the SAVTAP file containing 
the initial means has been 
assigned; m-1 is the number 
of files to be skipped on 
the unit; i is the number 
of the Fortran logical unit 
to which the SAVTAP file 
containing the generated 
statistics will be output; 
s-1 is the number of files 
to skip before writing the 
cluster statistics. 

C's are integer subclass or 
cluster numbers that 

(1) will be used in comput- 
ing the initial means, 

(2) refer to the SAVTAP 
JEile, and (3) must be a 
subset of the subclasses or 
clusters on the SAVTAP file. 

Causes the reading of the 
module STAT deck that imme- 
diately follows this card. 

A maximum of N iterations is 
performed in the initial 
split sequence . 


TABLE 9-1,- Continued 


Keyword 

SEQUEN 


STDMAX 


SEP 


PERCENT 


DLMIN 


Parameter and 
default values 

AA* * • A 

Default; SC 


X 

Default; 4.5 


X 

Default; Maximum of 
the channel standard 
deviations in the 
cluster 

N 

Default; 80 


X 

Default; 3.2 


Function 

The A's represent the 
sequence of S and C char- 
acters used for iteration 
control after the initial 
split sequence . A maximum 
of 19 characters may be 
input . 

On a split iteration/ splits 
any cluster whose maximum 
standard deviation is 
greater than X units . 

When splitting a cluster , 
separates the new clusters 
by a distance of X units. 


If the number of clusters 
flagged for splitting 
divided by the total number 
of clusters is less than 
or equal to then 

splitting stops. 

On a combine iteration, com- 
bines any two clusters whose 
means are closer than X 
units . 
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TABLE 9-1. - Continued. 


Keyword 

NMIN 

PMIN 

OPTION 

OPTION 

CHAIN 

KRN 

MAP 


Parameter and 
default values 


N 


STATS 

SRCOMP 


CHNTHS 

Default: Chaining 

not performed 


N 

Default; 20 
N 

Default; 20 


Function 

Deletes any cluster with 
fewer then N members on the 
first through next-to-last 
iteration . 

Deletes any cluster with 
fewer than N members on the 
last iteration. 

Prints the covariance matrix 
for each cluster . 

Prints a measure of the 
scattering of the clusters 
after each iteration . 

Chains all clusters within 
CHNTHS units of each other 
to form one cluster. Chain- 
ing affects only the final 
map printout and MAPUNT 
iile . 

Prints out a summary of the 
clusters at every N*^^ 
iteration . 

Prints out a map of the 
cluster data along with the 
summary for every N*^^ itera- 
tion. A final cluster map 
is printed regardless of 
this parameter. 
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TABLE 9-1.- Continued 


Parametor and 


Keyword 

default values 

Function 

FORMAT 

UNIVERSAL 
Default: Output 

MAPUNT file is nob 
generated . 

Generates the output cluster 
MAPUNT file in Universal 
format . 

format 

LARSYS 

Default; Output 
MAPUNT file is not 
generated , 

Generates the output cluster 
MAPUNT file in LARSYS 
format . 

SYMBOLS 

* * ’ 

Default; 1,2, •••,9, 
A, B , • • • , 2 ,— , 1 , n,/ , -, 
,=,0 , blank, =, 
r) r i t :/&/^ / J/? ^H, 

comma, period , blank 

Symbols used to identify 
clusters in the printout . 

OPTION 

ORDER 

Default; The color 
keys will be ordered 
according to cluster 
number . 

The color keys on the MAPUNT 
file will be ordered accord- 
ing to greenness . 

OPTION 

PUNCH 

» 

Punches the means and covar- 
iance matrix for each clus- 
ter in the module STAT deck 
format . 


Special cards, for 

Procedure 1 

DOTFIL 

INPUT/UNIT=n , PILE=m 
Default; Self- 
starting 

Defines the Fortran unit 
number n and file number m 
of the dot data file 


(DOTDNT) which contains 
the starting vectors. 


TABLE 9-1.- Concluded. 



F3.r,ameter and 

Function 

Keyword 

default values 

DOTS 

ni,n2, ■ • ‘ ,ngo 
Default: Dots will 

not be used for 
starting vectors . 

These integer numbers sepa- 
rated by commas specify the 
dots to be used as starting 
vectors . 

SUNANG 

TAPE 

Default; No Sun 
angle correction 
applied 

Sun angles are extracted 
from the Universal-forraatted 
MSS data tape . 

SUNANG 

ni,n2, • • • ,nj 
{nj} are integer 
numbers , j < 8 
Default; No Sun 
angle correction 
applied 

{nj } are the Sun angles to 
be used in computing the Sun 
angle corrections for use in 
the clustering algorithm. A 
Sun angle must be input for 
each acquisition whose chan- 


nels appear on the CHANNELS 
control card . 

Ancillary cards 


HEDl, HED2, DATE, COMMENT (see table 3-1) 














PJ 





Figure 9-1.- Concluded. 


\u 
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(a) The boomerang-shaped 
cluster. 


(b) The donut-shaped 
cluster. 


Figure 9-2.— Odd-shaped clusters. 




(a) Subclustering of the (b) Subclustering of the 

boomerang-shaped cluster. donut-shaped cluster. 

Figure 9-3.— Breaking up of the clusters into subclusters. 



2 


6.2 

3.1 

0.0 3.1 

6 . 3 CHNTHS 

3.2 

5.6 

3.1 0.0 

9.7 

11.8 

3.0 

6.3 9.7 

0.0 

(b) 

Intercluster distance 

table . 


Figure 9-4.— Example of chaining. 




10 . FEATURE SELECTION PROCESSOR — SELECT 


The feature selection processor, SELECT, provides a means of 
measuring the relative importance of the individual channels and 
obtaining the set of channels that provides the best discrimina- 
tion between subclasses . The processor allows the user to choose 
one of the following three criteria for measuring the separabil- 
ity of the subclasses for a set of channels or for linear combi- 
nations of the channels. 

• Weighted average interclass divergence 

• Weighted average transformed divergence 
« Weighted average Bhattacharyya distance 

Either the exhaustive search or the without replacement procedure 
can be used with one of the above criteria to select a "best" set 
of channels. The exhaustive search procedure determines the best 
set of k but of n channels by computing the separability measure 
for every possible combination of k channels. This results in 
n!/k!(n - k) I computations of the separability measure. The com- 
puter time required for this procedure is prohibitive for a large 
n. In such cases, the without replacement procedure can be used. 

The without replacement procedure determines the best k out of n 
channels in the following manner. First, the single channel that 
extremizes the separability measure is selected. Each of the 
remaining (n - 1) channels is paired with the best single channel 
to select the best pair of channels. The best triplet is deter- 
mined by combining the remaining (n - 2) channels with the best 
pair. The process continues until the best set of k channels has 
been selected. The number of times the separability measure must 
be computed isn+ (n-1) + (n-2) + ••• (n-k+1). 


A third procedure, the Davidon-Pletcher-Powell procedure, is a 
powerful iterative descent 'method for finding a local minimum of 
a function of several variables. The procedure is discussed in 
reference 7. How the procedure applies to the problem of channel 
selection or dimensionality reduction is discussed in reference 8. 
In SELECT, the Davidon-Fletcher-Powell procedure computes a k-by-n 
linear transformation matrix that extremizes a given separability 
measure. This matrix, referred to as the B-matrix, is saved on 
the BMFILE (section 4.2) and optionally is punched on cards 
(B~matrix deck, section 3. 2. 4. 2) for later input into the 
CLASSIFY, DATATR, TRSTAT, or SCTRPL processors. 

An initial guess for the B-matrix must be provided for the 
Davidon-Fletcher-Powell routines, and this guess may be input via 
the B-matrix on card deck or BMFILE. If the initial guess is not 
provided by the user, SELECT will execute the without replacement 
procedure first to obtain a best set of channels, which it will 
use as a first-guess B-matrix for the Davidon-Fletcher-Powell 
procedure . 

In addition to selecting a best set of channels and/or linear 
combinations, the processor will evaluate any one of the three 
separability measures for a specified linear combination of the 
channels. The linear combination must be input via the B-matrix 
deck or the BMFILE. This option is the fourth procedure referred 
to by the PROCEDURE control card . 

The processor can also evaluate any of the separability measures 
for specified sets of channels. This request is made using the 
EVALUATE and PROCEDURE control cards. This is the fifth option 
referred to by the PROCEDURE control card . 

The best subset of passes (Landsat acquisitions) from a set of 
passes can also be determined using the sixth procedure option. 


liu 


XO-2 


For Procedure 1 applications, the SELECT processor provides an 
option, CLSWT, to weight subclass pairs automatically. The proc- 
essor determines the class-subclass correspondence (after any 
grouping of subclasses by use of the GROUP control card) and 
assigns a weight of 1.0 to each subclass pair representing two 
different classes, pairs of subclasses from within one class are 
given a weight of 0.0. The APRIORI control card can be used to 
modify these weights with factors computed from the number of 
pixels in each cluster, 

see the functional flow chart for the SELECT processor 
( f ig . 10-1 ) . 

10 .1 INPUT FILES 

The SELECT processor requires the statistics output from either 
STAT or ISOCLS. Both STAT and ISOCLS write the SAVTAP file and 
optionally punch the module STAT file on cards (see section 

3. 2. 4.1 for format) which may be used as input to SELECT. 

‘10.2 OUTPUT FILES 

The BMFILE is output by SELECT when the Davidon-Fletcher-Powell 
procedure is used (see appendix J for sample execution). The 
file is written on logical unit 10. 

The corresponding B-matrix card file is punched if the OPTION 
PUNCH control card is included in the deck setup. 

10 .3 SCRATCH FILES 

Disk files are used as scratch files in SELECT. No assignment is 
necessary . 


10.4 CARD INPUT 


All system oar<3 input formats referred to in this section are 
defined in section 3. 

10. 4-1 PROCESSOR CARD 

The processor keyword is left justified starting in column 1, 
thus, 

SSELECT 

This card directs the system monitor routine to execute SELECT 
and initiates loading of routines used by SELECT. 

10.4.2 SYSTEM CARD PILES 

The processor will read and process the module STAT file and the 
B-matrix file. 

10.4.3 CONTROL CARDS 

Table 10-1 lists the control cards that are recognized by SELECT. 

10.4.4 FIELD DEFINITIONS 

Field definitions do not apply to the SELECT processor. 

10 .5 CARD OUTPUT 

SELECT outputs the B-matrix file on cards as an option (see con- 
trol card OPTION PUNCH) . This is optional output only when the 
Davidon-Fletcher-Powell procedure is executed. 

10.6 RESTRICTIONS 

The system-related restrictions in section 24 apply to the SELECT 
processor. 
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Two large arrays are dimensioned in SELECT and used for the vari- 
able dimensioning of several smaller arrays. Storage require- 
ments of one array are a function of the number of subclasses and 
channels requested , That is, 


number ofj 

/number of ^ A 
channels 1 

number of ^ 

number 

/number ^ .\ 

channels 

subclasses 

of best 

(of best j 


V 2 


L 



number of 
subclasses 


/number of Wnumber of 
\ subclasses/ \ subclasses 



S 10 600 


( 10 - 1 ) 


Storage requirements of the other array are dependent on the pro- 
cedure and criterion being used . The Davidon-Fletcher-Powell 
procedure requires much more storage than the other procedures, 
and the weighted average interclass divergence requires more 
storage than the other criteria. 


10 .7 DIAGNOSTIC MESSAGES 

Diagnostic messages for the SELECT processor are listed by sub- 
routine in appendix 1. 


TABLE 10-1.- CONTROL CARDS FOR SELECT 


Keyword (a) 

Parameter and 
default values (b) 


Function 


Required 

cards 


BEST 

N]_,N2, • • • /Nj^ 

Find the 

best set of 



Ni , N 2 / ' * 

• ,Nj^ channels if the 


exhaustive search or the 
without replacement pro- 
cedure is indicated. If the 
Davidon-Fletcher-Powell pro- 
cedure is indicated, the 
best Ni,N 2 /**vN)^ linear 
combinations of the channels 
are found. Ni^/N^/ • • * ^Nj^ are 
integers separated by commas . 

A request can be made for a 
maximum of 10 best in one call 
to SELECT. 


*END 

Blank 

Signals 
cards . 

the 

end 

of 

the 

control 

$END 

Blank 

Signals 

the 

end 

of 

all 

card 


input for this processor. 


^The keyword must be left justified in card columns 1 through 10. 

^The parameter values are in card columns 11 through 72 (beginning 
in any column past 10). 


TABLE 10-1.-* Continued. 


Keyword 

CHANNELS 


STATFILE 


MODULE 


Parameter and 

default values Function 


Optional cards 


Ci,C2f • • • 

k < number of chan- 
nels on SAVTAP <30 
Default: All chan- 

nels on the SAVTAP 
file 


SexGcts the best set of 
channels from those indi- 
cated on this. card. Must be 
a subset of the channels for 
which statistics are input 
via the SAVTAP file or the 
module STAT file. 

are integers sepa~ 
rated by commas . 


UNIT=n,PlLB»m n is the number of the For- 

Default: n=20,m=»l tran logical unit to which 

the SAVTAP file has been 
assigned; m is the number 
of the file from which the 
training statistics are to 
be retrieved . 


(NOTE; If the module STAT 
file is input, m is the 
number of the file on which 
the statistics are to be 
stored. If m 1, this con- 
trol card must precede the 
module STAT file in the 
control card deck setup.) 

Blank Indicates that the module 

STAT deck immediately fol- 
lows. The SAVTAP file will 
be written as this card file 
is read . 
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TABLE 10-X.- Continued. 


Keyword 

PROCEDURE 


INCLUDE 


ICOUNT 

BSPASS 


Parameter and 

default values Function 


N 

Default; N*2 


CifC-, • • • ,Cy^ 

Default: None 


N 

Default; N=300 


N 

Default: None 

N 

Default; N=4 


N»l; the exhaustive search 
procedure is used; N=s2; the 
without replacement proce- 
dure is used; N=3; the 
Davidon-Fletcher-Powell pro- 
cedure is used; N«4; the 
user-input B-matrix is used 
to evaluate the separability 
measure; N=5; the evaluate 
channels procedure is used; 
N=6; selects best subset of 

paSScS • 

Includes channels '^ 11 ^ 2 '’''' 
C]^ in the best set; meaning- 
ful only for- the without 
replacement procedure . 

Ci,C 2 , • • • /C]^ must be a sub- 
set of the channels on the 
CHANNELS card. 

Number of iterations for the 
Davidon-Fletcher-Powell 
procedure . 

N is the number of passes 
(Landsat acquisitions) to 
be included in the best set. 

Number of channels per pass . 


NCPASS 


TABLE 10-1.- 


Continued 


Keyword 

CRITERION 


EVALUATE 


B- MATRIX 


Parameter and 
default values 


N 

IDefault: N=1 


Ci,C2, • • • fC^ 

Default; None 


CARDS 

Default; None 


Function 

The indicated criterion is 
used to measure the separa- 
bility between subclasses. 
N=1 for weighted average 
divergence; N=2 for weighted 
transformed divergence; and 
N=3 for weighted average 
Bhattacharyya distance . 

Evaluates the separability 
measure indicated on the 
CRITERION card for channels 
Cj_ ,C2 / ’ ’ ' ,Cj^ . The set of- 
channels to be evaluated 
must be (1) a subset of the 
channels on the CHANNELS 
card and (2) must be on one 
card . Several sets of chan- 
nels may be input by using 
more than one EVALUATE card . 

Indicates that the B-matrix 
card deck immediately fol- 
lows; results in the evalua- 
tion of the separability 
measure using the linear 
combinations defined by the 
B-matrix if the fourth pro- 
cedure is indicated. If the 
Davidon-Fletcher-powell pro- 
cedure is indicated, the 
B-matrix will be used as a 
first guess . 
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TABLE 10-1.- CQntinuGd. 


Kaywoird 

B-MATRIK 


SUBCLASSES 


GROUP 


PacarftGtoi: and 
dofiault valuoa 

FILE 

Default; None 


Ki,I< 2. • ‘ • ?Ki 
i < number of sub- 
classes on 
SAVTAP <60 
Default; All sub- 
classes on the 
SAVTAP file 


NAME,1,J, • • • 

Default: No group- 

ing; individual 
subclasses are used. 


Function 

Indicates that a BMEILE has 
been written. Dependint 3 on 
the PROCEDURE card, the B- 
matrix on file will be used 
as an initial guess for the 
Davidon-Eletcher-Powell pro- 
cedure or in evaluating the 
separability measure. 

Provides for use of only 
subclass Kj_,K 2 , • * • ,l<i 
statistics for computation 
of the separability measure. 
Ki,K 2 ,‘'*/Ki are integers 
representing the subclass 
numbers as they occur in the 
SAVTAP file. 

Groups the training sub- 
classes pools their 

statistics; and assigns NAME 
as the group name . NAME may 
be any six characters. 
Integers I,J,*** must cor- 
respond to the subclasses as 
they occur in the module 
STAT deck or the SAVTAP 
file . 


TABLE 10-1.- Continued. 



' parameter and 

Keyword 

default values 

WEIGHTS 

C1«XX, (C1,C2)=YY, 
OTHERS =2 2 

Default; All weights 

4 

set to 1.0 for cri- 
teria 2 and 3. For 
criterion 1, weights 
for subclass pair 
(i,j) are W^j = 
C^ij/ie, where Dj.j 
is the divergence for 
subclass pair (i,j). 


Function 

Sets to XX weights for all 
subclass pairs involving 
subclass Cl; then sets to 
YY the weight for subclass 
pair (C1,C2); and finally 
sets to 22 the weights for 
all subclass pairs not 
already weighted . Sub- 
class names Cl, C2, etc., 
must match a subclass name 
from the module STAT file or 
from the SAVTAP file, or a 
GROUP NAME.^ See OPTION 
GLSWT for constraint. 


^Consider the problem of selecting the channels that best 
separate wheat from nonwheat classes, where wheat is divided 
into the subclasses Wl, W2, and W3 , and nonwheat is divided into 
the subclasses NWl, N\^2, NW3, and NW4 . It is desirable to set 
all weights for pairs of subclasses in the same class to 0, 
whereas wheat/nonwheat subclass pair weights ace set to 1. This 
can be accomplished by the following WEIGHTS control cards; 
Wl=l., W2=l., W3=l.; (W1,W2)=0., (Wl,W3)=0., (W2,W3)-0.; and 
OTHERS=0 . 

(1) Wl=l . will set weights equal to 1 for the follo\>/ing subclass 

pairs: (Wl,NWl), (W1,NW2), (Wl,NW3), (W1,NW4), (W1,W2), and 

(W1,W3) . 

(2) W2=;i . will set weights equal to 1 for the following subclass 

pairs: (W2,NW1), (W2,NW2), (W2,NW3), (W2,NW4), (W2,W3), and 

(W2,W1) . 

(3) W3=l. will set weights equal to 1 for the following subclass 
pairs; (W3,NW1), (W3,NW2), (W3,NW3), (W3,NW4), (W3,W1), and 
(W3,W2) . 

(4) (W-1,W2)=0., (Wl,W3)-0., and (W2,W3)-0. will reset these sub- 
class pair weights equal to 0. 

(5) OTHERS=0 . sets all other subclass pair weights to 0; namely, 

(NW1,NW3), (NW1,NW4), (NW2,NW3), (NW2,NW4), and 

(NW3,NW4) . 
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TABLE 10-X.“ Continued. 


Keyword 

OPTION 


APRIORI 


OPTION 


Parameter and 
default values 

CLSWT 


Blank 


STATS 

Default: No 

statistics printed 


Function 

The processor determines the 
class-subclass correspondence 
(after any grouping of sub- 
classes by use of the GROUP 
control card) and assigns a 
weight of 1,0 to all inter- 
class subclass pairs . 
Intraclass subclass pairs 
are given a weight of 0.0. 

(NOTE: The WEIGHTS control 

card remains available to 
allow the user to set weights 
for specific subclass pairs . 
If used, the input subclass 
pair weights override the 
processor-set subclass pair 
weights. The WEIGHTS OTHERS 
capability is not available 
when this option is exer- 
cised. If input, it is 
ignored by the processor.) 

This card causes the weights 
assigned to subclass pairs 
to be modified by factors 
computed from the number of 
pixels in each subclass , 

Prints a summary of the 
statistics for the sub- 
classes and channels actu- 
ally used in SELECT. 


TABLE 10-1.- Concluded. 


Keyword 

OPTION 


Parameter and 

default values Function 


RUN 

Default; Exit 
the processor 


This card allows the user to 
complete a run of this proc- 
essor for the case in which 
the input SAVTAP file has 
only one class . Such a run 
is not applicable when the 
fourth or fifth PROCEDURE 
option is being taken . 


Ancillary cards 

HEDl, [IED2, DATE, COMMENT (see table 3-1) 

























11 . CLASSIFICATION PROCESSOR ~ CLASSIFY 


The classification processor, CLASSIFY, classifies MSS image data 
on the basis of statistics (mean vectors and covariance matrices) 
computed from training fields or labeled clusters. 

11.1 PROCEDURES 

Using the statistics for each subclass of interest, the processor 
assigns each data point within the defined classification field 
to a subclass. It does so by one of two procedures. 

In the first procedure, the user does not define categories in 
his or her input, and the standard m-class maximum lilcelihood 
classification rule is followed. To decrease the number of times 
the density function must be computed, the classif ication-by- 
thresholding procedure proposed by Hallum and Minter (ref. 9) and 
improved upon and implemented by Feiveson (ref. 10) is used. The 
standard classification rule (i.e., when no categories are 
defined by the user) is outlined in section 11.1.1. 

In the second procedure, the user defines categories in his or 
her input, and the sum-of-normal-densities classification rule is 
followed, as set out in section 11.1.2. 

11.1.1 STANDARD M-CLASS CLASSIFICATION 

Assuming multivariate normal probability density functions and 
using the maximum li)<elihood classification rule, the data vector 
= (Xi,X2,X3,--*, Xjq) is assigned to subclass i in the following 
manner . 

The assumed joint probability density function of X is give in 
the following equation. 


(U-1) 


where 


P^(X) 


(27r)^/^lK. 


£72 


g-0.5Qi(X) 


aj_ = a priori probability for subclass i 
N = number of channels used for classification 
= covariance matrix for subclass i 
Qj_ = Gaussian quadratic form = (X - (X - 

X = data vector (X]^,X2/X3, • • • ,X]^) 

= mean vector for subclass i 

Because of the exponential form of Pj_ and because S-n(Pj^) is a 
monotonically increasing function of Pj^, for computational pur- 
poses it is convenient to define a new function by 


= An(p. ) = iln(a. ) - | An(2Tr) - | AnlK^I - | (X - y.)'^K5^^(X - y.) 

( 11 - 2 ) 

The data vector X is classified as belonging to subclass i if 
Vj_ > Vj for all i * where j = 1,2,3, •••,n and n = number of 
subclasses . 


The number of times the function must be computed may be 
reduced by the use of thresholds; i.e., real numbers y.. 

13 

(independent of X) such that 


and 


Vf(X) > Y.j implies V.(X) > Vj(X) 
Vj(X) > Yij implies V^(X) > v^(x) 


(11-3) 


where i,j = l,2,3,'**,n and i 5^ j . 


The values of Yj,j are computed from input statistics as part of 
the initialization of processor CLASSIFY. The utility of these 
thresholds is that, if Vj^(X) > computed. 
Once the values for Y^j have been determined, they may be used 
for each observation vector X. 


11.1.2 SUM-OF-NORMAL-DENSITIES CLASSIFICATION 

Also assuming multivariate normal probability density functions', 
the category classifier classifies the data vector X*^ = 
(Xj_,X 2 /X 3 , * • • ,X]^) to category r and subclass i in the following 
manner . 


The probability density function for each category r is computed 
by the following equation. 


P,(X) 


M 

r 

£ 

1=1 


(2tt) 




K, 


T72 


g-0.5Q. (X) 


i=l ^ 

where 

i = subclass number 

* 

r = category number 

Mj, = number of subclasses in category r 

aj_ = a priori probability for subclass i in category r 

N = number of channels .used for classification 

T —1 

Q£(X) = Gaussian quadratic form = (X - (X - 
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Having computed the probability density function for all cate- 
gories, the data vector X is classified as belonging to category r 

if P.. > P^/ for all V * B, where s = 1,2,3, •••,S and S » number of 
r s 

categories . 

The data vector is classified as belonging to subclass i if the 
probability density function for subclass i in category r is such 
that P|^i > P^ni for all i m, where m = 1, 2 , 3 , • • • , In the 

computation of Pj-, if the value of the quadratic form Q^CX) is 

smaller than -88, the computer cannot store the computed value of 
aQi(X). Thus, e*3i(^) = o for Qj_(X) < -88. In the case of 

all Pgj_(X) = 0 for s = 1,2,3,***,S, the data point will not be 

classified; it will be assigned to a null subclass. 

When the line-printer map of the classified data is displayed, 
each data point is printed with the symbol representing the 
legitimate subclass to which the data point belongs, and the null 
subclass is printed with the blank symbol . Figure 11-1 gives the 
functional flow of the CLASSIFY processor. 

11.1.3 PROCEDURE 1 

For Procedure 1 applications, the CLASSIFY processor allows the 
option of obtaining subclass a priori values from subclass popu- 
lation data in the input statistics file, SAVTA'P. It also allows 
the system to use the class names from SAVTAP as the assigned 
category names. 

Both options are in addition to the usual capability of the 
analyst to input a priori probability values at the subclass, 
class, or category level via the APRIORI control card and to 
input category names via the CATEGORY control card . 


11.2 INPUT FILES 


An MSS data file must be input to the CLASSIFY proeessotr. The 
assignment defaults to logical unit 11? however, by input of the 
DATA control card, the user may assign any available logical 
unit. (See table 4-1 for file assignments and section 3.1, Image 
Tapes, for further information on format.) 

11.3 OUTPUT FILES 

The classification results are output on the MAPTAP file (see 
appendix DJ , which is defaulted to logical unit 2. In the event 
of card input of the module STAT file, the statistics will be 
output on the SAVTAP file (see section 4.1). 

11.4 SCRATCH FILES 

The processor requires no scratch file . 

11.5 CARD INPUT 

All required input card types are described below. 

11.5.1 PROCESSOR CARD 

The processor )<eyword is left justified beginning in column 1, 
thus , 

$CLASSIFY 

This card directs the system monitor routine to load all routines 
used by the CLASSIFY processor. 

t 

11.5.2 SPECIAL SYSTEM PILES 

The training statistics may be input by means of the module STAT 
file. The B-transformation matrix may be input by means of the 


B-matcix file, The EOD-LARSYS deck formats are described in sec- 
tion 3.2. The use of card input is an option? normally, card 
image files are used. 

11.5.3 CONTROL CARDS 

Table 11-1 describes the complete set of control cards recognized 
by the CLASSIFY processor. Ordering of the sequence of processor 
control cards is unnecessary, with the exceptions that (1) the 
*END card must follow the last processor control card, (2) the 
$END card must follow the last field definition card for an area 
to be classified, and (3) the STATFILB control card must precede 
the input of the module STAT file in some cases . 


11.5.4 FIELD DEFINITIONS 


An area to Be ciassitiea is defined for the classification proc= 
essor by a field definition card (described in section 3.2.3), 
which contains the scan line and sample coordinates for the area 
over which classification is to be performed. At least one field 
definition card must be in the run deck immediately following the 
*END control card. As many field definition cards as there are 
areas to be classified may be input. The processor will classify 
each field in the order in which it is identified. It will print 
on the line printer the first 110 samples of the classification 
map. And, for each field classified, it will print any optional 
output prescribed by the control cards. The scan line and sample 
coordinates specified on the field definition card must be 
available on the input MSS data file . 


11.6 CARD OUTPUT 


The classification processor outputs no punched cards. 


1 


11 .7 RESTRICTIQMS 

The system-related restrictions described in section 24, along 
with the following, apply to the CLASSlB'y processor, 

The category, class, and subclass relationship is as follows; 

number of . number of . number of . gQ 
categories - classes - subclasses - ^ 


The size of the B-matrix cannot exceed 450 locations; 

/ number of 1 inear Wnumber of channels^ . 

\ combinations j\ in B-matrix / - VJ-x-o; 

The channels used in computing the B-matrix automatically replace 
the channels, if any, on the CHANNELS control card, 


I 


j The difference between the largest sample number of the classifi- 

% cation field and the smallest sample number of the classification 

^ field cannot exceed 1000 . 

, Beginning with the smallest sample number of the classification 

field, only the next 110 samples are displayed on the line- 
printer map output by CLASSIFY, but the entire classified field 
\ is displayed on the line-printer map output by DISPLAY. 

I 

! 

1 When applying the category classifier option, 12 500 storage 

i locations are reserved by the data such that 

^ (points per scan line) (number of channels) < 12 500 (11-7) 

i’ 
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When applying the standard classifier option, the table computed 
for the class-pair thresholding procedure shares this storage of 
12 50C locations reserved for the data such that 


/ number of 
\ subclasses 


/ number of _ 

vsubclasses ~ I number of 
2 subclasses 


+ 


(points per scan line) 


/ number of \ 
^channels / 


< 12 500 


( 11 - 8 ) 


11.8 DIAGNOSTIC MESSAGES 

The diagnostic messages and the routines in which t ■; appear are 
listed in appendix I. 


11-8 



TABLE J.l-l.- CONTROL CARDS FCR CLASSIFY 


Parameter and 

Keyword (a) default values (b) Function 

Required cards 

MAPTAP OUTPUT/UNIT«n,FILE=m Unit and file number of 



(usually n=2,m=l) 

classification map. This 
must be the first card afte 
$CLASSIFY. 

*END 

Blank 

Signals the end of the con- 
trol cards . 

$END 

Blank 

Signals the end of all card 
input for this processor. 


Optional 

cards 

DATA 

UNIT=n,PlLE=m 
Default; n=«ll,m=l 

n is the number of the For- 
tran logical unit to which 


the MSS data file has been 
assigned; m-1 is the num- 
ber of files to be skipped 
on the unit. For back-to- 
back execution of several 
processors, if using the 
same file number, only one 
DATA control card need be 
input . 


®The keyword must be left justified in card columns 1 through 10. 

®^The parameter values are in card columns 11 through 72 (beginning 
in any column past 10). 
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TABLE 11-X 


Continued . 


Keyword 

CHANNELS 


STATE I LE 


Parameter and 

default values Function 


STAT=Ni,N2a * • • /N)^, 
DATA=Mj_ ^ ^2 / • * • / 
k < 30 

Default; (1) If 
executed back to 
back with SELECT, 
the channels selected 
by the SELECT proc- 
essor are used . 

(2) If a B-matrix is 
input, the channels 
resulting from the 
matrix applies^ on 
are used. (3) Other- 
wise, all channels 
in the training sta- 
tistics are used . 


N 1 /N 2 / • * * /N)^ are the chan- 
nel numbers (integers) from 
the SAVTAP file to be used 
in classification; 
^l'^2'’**'^k channel 

numbers (integers) from the 
MSS data file (DATAPE) . The 
number of channels selected 
from SAVTAP and DATAPE must 
be equal . 


UNIT=n,FILE=m n is the number of the For- 

Default; n=20,m=l tran logical unit to which 

the SAVTAP file has been 
assigned; m-1 is the number 
of files to be skipped on 
the unit. 


(NOTE; If the module STAT 
file is input, m is the 
number of the file for 
storing the statistics. 

If m 7 ^ 1, this control card 
nust precede the module STAT 
deck in the control card 
file setup.) 
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TABLE 11-1. 


Continued . 


Keyword 

SUBCLASSES 


MODULE 


B-MATRIX 


Parameter and 
default values 

Ki,K2,--*rKi 

i < number of 
subclasses on 
SAVTAP <60 
Default: All sub- 

classes on the 
SAVTAP file 

Blank 


CARDS or PILE 
Default: No trans- 

formation of training 
subclass covariance 
matrices 


Function 

Provides for use of only 
subclass Kj_,K 2 a • • • sta- 
tistics to classify the 
unknown data points. 
^l'^2'*’‘'^i integers 

representing the subclass 
numbers as they occur in 
the SAVTAP file. 

Indicates to the processor 
that the training subclass 
statistics will be input on 
cards. The module STAT file 
must immediately follow this 
control card . 

Informs the processor that 
the B-matrix transformation 
is to be input and applied 
to the training subclass 
statistics before classifi- 
cation. If FILE is placed 
in the parameter field, the 
mode of B-matrix input will 
be from BMFILE; if CARDS is 
specified, the B-matrix card 
deck must immediately follow 
this control card. The 
channels resulting from the 
B-matrix transformation will 
be the channels used by the 
processor in classification. 
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TABLE 11-1.- Continued. 


Keyword 

GROUP 


APRIORI 


Parameter and 
default values 

SUBNAM,K2,rK2r’ * * 
i < number of 
subclasses on 
SAVTAP <60 
Default: No group- 

ing of subclasses 


^1 ^ ^2 , • • • , A[^ 

or 

N*Ai,K*An+i,'-‘,A^ 

M < 60 

Default: If execut- 

ing the standard 
classifier, each 
subclass is given an 
equal a priori value. 
If executing the 
category classifier, 
each category is 
given an equal 
a priori value which 
is divided equally 
among the subclasses 
in that category. 

11-12 


Function 

K^^'s are integer subclass 
numbers taken from the set 
of available training sub- 
classes. The processor 
creates a new training 
subclass by combining the 
statistics of the training 
subclasses listed. The set 
of training subclasses to be 
used is renumbered by the 
processor. SUBNAM may be 
from one to four characters; 
it becomes the name of the 
new training subclass . 

A priori probability values 
may be input by subclass, 
class, or category. N or K 
is the number of times the 
value is repeated, and the 
Aj_’s are decimal numbers 
M 

such that X] 1.0. 

i=l 

M = number of training sub- 
classes, training classes, 
or categories. If input by 
class or category, the setup 
routine will distribute 
the a priori values among 
the subclasses in the 
follov/ing manner. 


HI 


TABLE 11-1.- Continued. 


Keyword 


APRIORI 


CATEGORY 


Parameter and 

default values Function 


By 


class a priori 

class = values ^ 

number of sub- 
classes in that 
class 


category 

By category = a. , , E cj ogi va l ues 
number of sub- 
classes in that 
• category 

The order in which the 
a priori probability values, 
Aj_, are input must be the 
order in which the cate- 
gories, classes, or sub- 
classes were defined . 


FILE 

Default; Subclass 
a priori values will 
not be computed from 
the statistics file, 
SAVTAP . 

CATNAM/NAMEj_ , NAME 2 , • • * 
Default; If no 
categories are defined, 
the standard m-class 
classifier is applied . 


The subclass a priori prob- 
ability values are computed 
using subclass or cluster 
point populations from the 
statistics file, SAVTAP. 

Informs the processor that 
the CATEGORY classifier 
option will be taken and 
defines a category name 
(CATNAM) and the class names 
(NAMEj_'s) included in this 
category. All subclasses 
for a class are assigned to 
this category. CATNAM and 


TABLE 11-1.- Continued. 


Keyword 


CATEGORY 


Parameter and 
default values 


FILE 

Default: No cate- 

gories are defined, 
and the standard 
classifier will be 
applied . 


Function 

NAME^ may be up to four 
characters, and NAMEj[ must 
match a class name on the 
SAVTAP file. A slash (/) 
separates the category name 
from the class name . 

(NOTE: (1) Every class will 

be assigned to a category 
unless the class was elimi- 
nated by omitting all of its 
subclasses using the SUB- 
CLASSES control card. (2) At 
least two categories must be 
defined. (3) Continuation 
of the list of class names 
in the category on another 
card is indicated by an 
asterisk after the last 
class name on that card . 

The next card should con- 
tinue the list of class 
names in columns 11-72.) 

Initiates the assigning of 
the category names using the 
class names from the input 
statistics file, SAVTAP, and 
invokes the category 
classifier . 


TABLE 11-1.- Concluded. 


Keyword 

OPTION 


Parameter and 

default values Function 


STATS 

Default; No train- 
ing subclass sta- 
tistics printout 


Training statistics will be 
printed out for each sub- 
class, reflecting the 
B-matrix transformation, if 
any, and the Cholesky factor- 
ization of the covariance 
matrices . 


Ancillary cards 


HEDl, HED2, DATE, COMMENT (see table 3-1) 


CLASSIFY 


iNTEAPRET ySEA'iNPuT OPTIONS. 

SELECT RE5UESTE0 SUBSET OF STATISTICS 
FROM SAVTAP file PERFORM THE LINEAR 
TRANSFORMATION ON STATISTICS IF 
a-MATRIX IS INPUT. OBTAIN CMOLESKY 
DECOMPOSITION OF COVARIANCE MATRICES 

determine a prior prodability for 

EACH SUBCLASS EITHER FROM USER INPUT 
OR FROM 'uaCLASS PIXEt POPhlATI-ON. 


CATEGORIES ^ 
OEFINEO EITHER 
BY USER OR BY CLASSES 
«s^ PROM SAVTAP? ^ 


COMPUTE TABLE OF THRESHOLDS 
Cy-.) FOR ALL SUBCLASS 

PAIRS I AND j 


SET ! « I OR SUBCLASS TO WHICH 
LAST PIXEL WAS ASSIGNED 


COMPUTE DENSITY FUNCTION p. 
FOR PIXEL X, SUBCLASS I 


SET I TO A NUMBER LESS THAN 
THE NUMBER OF SUBCLASSES i I 
AND |t TO SOME PREVIOUS j 
ALREADY TESTED 


FOR EACH pixel, pixel X BELONCS 
CATEGORY r IF 

TO 

P FOR ALL r 5, s » !.»• 
t* G 

,S 

WHERE P,,{X! - S P^,iX) 

» i«l 


P, - POSTERIOR SUH-OF-OENSITIES 
OlSTRIBUtTON 

M . number of subclasses IN CATEGORY r 

AND X BELONaS TO SUBCLASS i IF 

P . * P FOR ALL 1 -n, (n • i . 

^ ri rni 





Figure 11-1.- Functional flow chart for the CLASSIFY processor 










Figure 11-1.- Concluded 
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12, DISPLAY OF CLASSIFICATION RESULTS PROCESSOR — DISPLAY 


The DISPLAY processor reads the MAPTAP file output by CLASSIFY 
and performs the following functions . 

a. Provides a line-printer map of each classified field on 
MAPTAP. The training and test fields within the classified 
image are outlined . 

b. Produces a classification summary for each classified field, 
which gives a breakdown of the number of pixels classified 
into, and the number of pixels thresholded from, each sub- 
class, class, and category. 


c. Produces (optionally) an intensive test site (ITS) classifi- 
cation summary for one crop type versus all other crop types 
the user-specified crop may be a category, class, or 
subclass . 

d. Allows the user to designate fields to be excluded from the 
classification summaries. Fields may be designated "uniden- 
tifiable" or "other." Pixels within the unidentifiable 
fields are counted and are not considered in the classifica- 
tion summaries. Pixels within the designated "other" fields 
are counted as a separate crop type regardless of how they 
were classified. These pixels are included in category 
"other" in the ITS report. (See section 12.4.4 for sample 
input of DO/DU fields.) All pixels within the DO/DU areas 
are printed with the pound (f) symbol. Also, classification 
results can be overridden for fields designated as of a cer- 
tain class by use of a designated [class name] card. 

e. Assigns a pixel to the threshold class if thresholding is 
requested and if > t£, where 

m ,, I 

Q£ = the value of the quadratic form (X - y^) (X - p^) as 
computed by CLASSIFY (section 11.1.1) for subclass i 


= mean vector for subclass i 


preceding page 


blank not f 
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=» covariance matrix for subclass i 

ti » threshold value for subclass i 
f. Allows t^ to be determined in one of four ways; 

• User input — The user inputs the exact threshold value . 
See control cards THRESHOLD and OPTION THRESHOLD VALUE. 

• Chi-square option — The user inputs confidence levels for 
each subclass on the THRESHOLD card and includes the 
OPTION CHI SQUARE. The program obtains the chi-square 
threshold value from an internal chi-square functional 
routine . 

• Empirical option — The user inputs confidence levels for 
each subclass on the THRESHOLD card and includes the 
OPTION EMPIRICAL card . The program determines the 
empirical distribution function for each subclass from 
the cumulative histogram of Qj_ for correctly classified 
pixels in the ground truth areas (i.e., training or test 
fields), as shown in the following example. 
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S' *-r-. 


. 


From this curve, the user input of a 95-pereent confidence 
level for subclass i would result in a threshold value of 
6.0. See reference 11 for more information on the use of 
empirically computed thresholds. 

• Fisher F-distribution option — The user inputs confidence 
levels for each subclass on the THRESHOLD card and 
includes the OPTION FISHER card . The program obtains the 
F-distribution threshold values from an internal routine . 
If a computational overflow occurs in the routine, the 
threshold value for that subclass is set equal to 999 .999 . 

Produces plots of the empirical distribution function when 
OPTION PLOT is exercised . 

Performs (optionally) a four-nearest-neighbors spatial fil- 
tering on the classified image. This algorithm takes into 
consideration that, in many instances, a pixel is probably 
like its nearest neighbors. When the option is exercised via 
the OPTION FILTER control card, the four nearest neighbors of 
each pixel are examined. If all the neighbors are classified 
the same and the pixel in question is classified differently, 
then it is assumed that the pixel was classified incorrectly 
and its classification is changed. In the following example, 
the pixel classified as X will be changed to C. (See 
reference 12 for more information on this algorithm.) 

Line 1 C 

2 C X C 

3 C 

Outputs (optionally) the classified image (MAPQNT) onto tape 
or disk in either LARSYS II/III or Universal format via the 
FORMAT control card . 

Provides classification performance summaries for ground 
truth areas within the classified image. The following six 
performance summaries are available to the user. The fields 


in these reports are either training fields used in the t^TAT 
or ISOCLS processor and transmitted to DISPLAY via the MAPTAP 
file, or test fields input directly to DISPLAY (see sec- 
tion 12.4 .4) . 

• Field by subclass 

• Field by class 

• Field by category 

• Class by subclass 

• Class by class 

• Class by category 

In procedure 1 applications, DISPLAY is able to 

1. Accept a LACIE-formatted dot file (GTUNIT, PPUNIT, or 
AIUNIT) . 

2. Provide a dot classification performance summary by dot 
categories which also includes 

• A tabulation of both the uncorrected proportion and 
the bias-corrected proportion of each dot category in 
the total area classified . 

• A confusion table which tabulates proportions for 
each labeled category of bias correction (type 2) 
dots. For each category, the number of dots analyst 
labeled as belonging to that category and machine 
classified into that and each other possible category 
is compared to the total number of dots classified 
into each category. 

3. Provide a dot classification performance summary for each 
dot on the analyst's specified file (GTUMIT, PPUNIT, or 
AIUNIT) . 


The functions of the DISPLAY processor are such that the analyst 
may either exercise the initial processor capabilities (a) 
through (j) or the LACIE Procfedure 1 capabilities (k) . The dif- 
ference between the two capabilities is in the type and format of 
the classification performance tables output. 

Figure 12-1 shows a function flow chart of the DISPLAY processor. 

12 .1 INPUT FILES 

The only input file required for DISPLAY is the MAPTAP file 
(section 4.4) output by CLASSIFY. This file must be assigned to 
logical unit 2. 

For Procedure 1, the DISPLAY processor accepts as input a LACIE- 
formatted dot file (GTUNIT, PPUNIT, or AIUNIT) created by the 
DOTDATA processor. The file is assigned either to logical unit 19 
or to a user-specified unit. 

12.2 OUTPUT FILES 

The DISPLAY processor will optionally generate a tape or disk 
file of the classified image on the MAPUNT for display. The con- 
trol card FORMAT allows the user to exercise this option. The 
tape .is usually assigned to a nine-track tape drive for compati- 
bility with display devices. The file assignment must be made to 
logical unit 16. 

For Procedure 1 , the DISPLAY processor optionally provides dot 
data classification performance summaries (instead of the normal 
output Glassification summaries described under j above) if the 
GTUNIT, PPUNIT, or AIUNIT control card is input to the DISPLAY 
processor . 
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12,3 SCRATCH RILES 


The disk provides random access storage for a scratch file^ in 
DISPLAY. No assignment is necessary. 

12.4 CARD INPUT 

All system formats referred to in this section are defined in 
section 3. 

12.4.1 PROCESSOR CARD 

The processor key«vord is left justified starting in column 1; the 
parameter PILE is punched starting in column 11, -hus , 

$DISPLAY PILE=N 

This card directs the system monitor routine to select the 
DISPLAY processor and initiates the loading of routines used by 
DISPLAY. Parameter value N is the file number on the MAPTAP file 
to be processed; if not input, default is to file 1 of MAPTAP. 

12.4.2 SPECIAL SYSTEM PILES 

NO special files are required for the DISPLAY processor. 

12.4.3 CONTROL CARDS 

Table 12-1 lists the control cards and available options for the 
DISPLAY processor. 

12.4.4 CLASS, SUBCLASS, AND PIELD DEPINITIONS 

Both test and designated fields are optional input to DISPLAY. 

If no test fields are input, the ground truth summaries will be 
for training fields. When input, test fields must be identified 
with a previously defined class or subclass. All test class, 
subclass, and field definitions begin immediately following the 
*END control card and are terminated by the $END control card . 
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Formats foe the CLASS, SUBCLASS, and field definition cards are 
defined in section 3.2.3. The following example shows test field 
input to DISPLAY. Note that test fields are identified by 
classes; that is, each NAMEl, NAME2, NAMES, etc., must match the 
name of a class defined in either STAT or ISOGLS and used in 
CLASSIFY. 

SDISPLAY 
( Control cards ) 

*END 

GLASS NAMEl 

Field 1 Vertices 

Field 2 Vertices 

CLASS NAME2 
Field 3 Vertices 

Field 4 Vertices 

Field 5 Vertices 

CLASS NAMES 
Field 6 Vertices 

SEND 

In the following example, test fields are identified with sub- 
classes, in which case each NAMEl, NAME2, NAMES, etc., must match 
the name of a subclass used in CLASSIFY. 

? DISPLAY 
(Control cards) 

*END 

SUBCLASS NAMEl 

(Test fields for subclass NAMEl) 

SUBCLASS NAME2 

(Test fields for subclass NAME2) 

SEND 

Note that actual name must not exceed four characters. 


Designated fields are large areas within the classified area 
which are unidentifiable or can be specifically identified as 
being other than the crop type of interest. This type of field 
input is meaningful only when the ITS summary report is being 
generated for one specific crop type. Pixels within unidenti- 
fiable areas are removed from the summaries altogether. Pixels 
within the designated "other" areas are counted as other 
regardless of how they were classified. 

An example of input designated fields follows . 

$DISPLAY 
(Control cards) 

*END 

DESIGNATE UNIDE 
(Field definitions) 

DESIGNATE OTHER 
(Field definitions) 

SEND 

If Procedure 1 is to be carried out, the only kinds of fields 
that should be input are 00/DQ fields. Test fields should not 
input; the counterpart of test fields are the bias correction 
dots on the LACIE-formatted dot file. The format of the DO/DU 
field cards and the method of input are given in section 3.2.3. 

Another usage of designated fields is the specification of a 
class name on the DESIGNATE card image. This causes the classi 
fication of pixels in subsequent field definitions to be over- 
ridden as far as performance summaries are concerned . 

The user may input any combination of the three types of 
designated fields. 


12.5 CARD OUTPUT 


No cards are output by the DISPLAY processor. 

12.6 RESTRICTIONS 

The system-related restrictions given in section 24 apply to this 
processor . 

12.7 DIAGNOSTIC MESSAGES 

Diagnostic messages for this processor are presented in 
appendix I. 


TABLE CONTROL CARDS FOR DISPLAY 


Keyword (a) 


MAPTAP 


*END 


$END 


Parameter and 

default values (b) Function 

Required cards 

INPUT/UNIT=n,FILE=m Unit and file number of 

(usually n=2,m=l) classification map. 

Signals the end of the 
control cards . 

Signals the end of all card 
input for this processor. 


SYMBOLS 


OPTION 


OPTION 


Optional cards 


Sl/S2r • • • fSj, 

k = number of sub- 
classes on MAPTAP 
Default: 1,2, • • • ,9, 

A,B,C,D,* • • ,S,— , I ,n, 

,=,0, blank, 

f { f 

comma , period , blank ,/ 
OUTLINE 

Default: Training 

fields are not 
outlined . 

NOMAP 

Default: Map 

printed 


Assigns symbols Sj_,S 2 / • • • ? Sj. 
to subclasses 1,2, 
respectively. 


Outlines training fields 
with asterisks; has no 
effect on test fields. 

(Test fields are always 
outlined with symbol.) 

Instructs the processor not 
to print a map of the data; 
only a performance summary 
is printed . 


®The keyword must be left justified in card columns 1 through 10, 

^The parameter values are in card columns 11 through 72 (beginning 
in any column past 10) . 
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TABLE 12-1.- Continued. 


Keyword 

OPTION 


CROP 


ACREAGE 


SITE 

PROCEDURE 


Parameter and 
default values 

STAT 

Default: No statis- 

tics printed 

NAME 

Default: No ITS 

report 


TOTAL=X,CROP=Y, 

OTHER=Z 


Any 24 characters 
Default: Blanks 


Any 60 characters 
Default: Blanks 


Functio n 

Prints statistics for sub- 
classes used in the previous 
CLASSIFY run. These statis- 
tics are saved on MAPTAP , 

Initiates the option of 
printing the ITS summary 
report for the crop indi- 
cated. Name must match a 
category, class, or sub- 
class name used in CLASSIFY. 

The total acreage in the ITS 
is X? the acreage of the crop 
named on the CROP control 
card is Y; and the acreage 
of all other crop types in 
the ITS is Z. X, Y, and Z 
are floating-point numbers . 
This input is meaningful 
only if the CROP control 
card is input . 

Name of the ITS; used in 
printing the heading for 
the ITS summary report. 

Procedure used in classifi- 
cation of ITS; printed in 
the heading for the ITS 
summary report. 


TABLE 12-1.- Continued. 


Keyword 

ANALYST 

THRESHOLD 


Parameter and 
default values 

Any 18 characters 
Default; Blanks 


Ti/T2,‘ • • /T}^ 
k = number of sub- 
classes on MAPTAP 
Default; No 
thresholding 


Function 

Name of the data analyst; 
printed in the heading for 
the ITS summary report . 

Uses the threshold values 
Ti,T 2 /***/Tk for subclasses 
1,2, •••,k, respectively; 
thresholds must be positive 
floating-point numbers. 

One value must be specified 
for each subclass on the 
MAPTAP file. Thresholds 
may also be specified in 
the following format; 

Ni*Ti,N2*T2, • • • 

where Nj_ and N 2 integers 
which specify how many con- 
secutive times the corre- 
sponding thresholds should 
be used . 

For the THRESHOLD VALUE 
option, the numbers input 
on the THRESHOLD cards are 
the actual values to be 
used for thresholding 
(i.e., T 3 ^= 10.02 means that 
the threshold value for 
subclass 1 is 10.02). 


TABLE 12-1.- Continued. 


‘ Parameter and 

Keyword default values 


OPTION THRESHOLD VALUE 

Default 


OPTION CHI SQUARE 

Default 


OPTION EMPIRICAL 

Default 


Function 

For the CHI SQUARE and 
FISHER options, the numbers 
are input on the confidence 
levels (i.e., Ti=0.99 means 
that the user wants to 
retain 99% or reject 1%) . 

For the EMPIRICAL option, 
the numbers input on these 
cards are percentages . 

Uses the numbers input on 
the THRESHOLD control card 
for the actual threshold 
values . 

Computes thresholds from the 
chi-square distribution 
using the confidence levels 
input on the THRESHOLD 
control card . 

Computes the empirical 
threshold values using the 
percentages input on the 
THRESHOLD control card . 


^If the THRESHOLD control card is input, one of the four options 
(CHI SQUARE, FISHER, EMPIRICAL, or THRESHOLD VALUE) should be 
iv.put also. If the OPTION card is omitted and the THRESHOLD 
card is input, chi square is assumed. If more than one THRESH- 
OLD option- is input, only the last one read will be performed. 
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TABLE 12-1.“ Continued. 


Keyword 

OPTION 

Parameter and 
default values 

FISHER 

Default 

Function 

Computes thresholds from the 
Fisher F-distribution using 
the confidence levels input 
on the THRESHOLD control 
card . 

OPTION 

PLOT 

Plots the empirical distri- 
bution functions obtained 
from the cumulative histo- 
grams of for each 

subclass . 

OPTION 

FILTER 

Default: Spatial 

filtering is not 
performed . 

Performs four-nearest- 
neighbors spatial filtering 
on the classified image. 

OPTION 

PCT 

Default; Perform- 
ance summary printed 
for classes only 

Prints a performance summary 
on a per-field as well as a 
per-class basis for ground 
truth fields (i.e., training 
or test fields within the 
classified image) . 


the THRESHOLD control card is input, one of the four options 
(CHI SQUARE, FISHER, EMPIRICAL, Or THRESHOLD VALUE) should be 
input also. If the OPTION card is omitted and the THRESHOLD 
card is input, chi square is assumed. If more than one THRESH- 
OLD option is input, only the last one read will be performed. 
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TABLE X2-1.- 

Continued . 

Keyword 

Parameter and 
default values 

Function 

FORMAT 

NAME 

If NAME=UNIVERSAL, the out- 


Default; No output 

put classification tape 


classification map 

(MAPUNT) will be generated 


is generated by 

in the Universal format. If 


DISPLAY. 

NAME=LARSYS, the MAPUNT tape 
will be generated in the 
LARSYS II/III format. 


Special cards, for Procedure 1 or LIST 
(Label Identification from Statistical Tabulation) 

GTUNIT 

UNIT=n,FILE=m 

Unit and file number of 


(usually n=23,m=l) 
Default; None 

ground truth dot file. 

PPUNIT 

UNIT=n,FILE=m 

Unit and file number of 


(usually n=27,m=l) 

dot file labeled by the 


Default; None 

Patterson-Pitt-Thadani 
discrimination procedure 
or any LACIE-formatted 
labeled dot file. 


TABLE 12-X.- Concluded. 


Keyword 

AIUNIT 


NAME 


ALPHA 


Parameter and 

default values Function 


UNIT»n,PILEnm 
(usually n=28,m»l) 
Default: None 


One-character name 
of selected category 
Default; S 


Unit and file number of 
Al-labeled dot file. 

(NOTE; Inclusion of any 
of the GTUNIT, PPUNIT, or 
AIUNIT cards initiates dot 
label comparison with 
machine classification 
results. In normal proc- 
essing, the AIUNIT card 
would be present. This 
card replaces the DOTFIL 
card previously used in 
the DISPLAY processor.) 

Category name of the cate- 
gory of interest if LIST- 
type reports are needed , 


F]_,F 2 Floating-point weighting 

Default: 0.5, 0.5 factors used in bias correc- 

tion reports. 


Ancillary cards 

HEDl, HED2, DATE, COMMENT (see table 3-1) 



Figure Functional flow chart for the DISPLAY processor 






























13 . DATA TRANSFORMATION PROCESSOR — DATATR 


13.1 PROCEDURES 

The DATATR processor transforms images from the MSS data file . 

The affine transformation ' performed on user-defined, fields 
according to the following formula; 

z = Bx + S (13-1) 

where 

z => a k-by-1 transformed data vector 
k < 16 

B = a k-by-n input transformation matrix (see section 3. 2. 4. 2) 
n < 30 

X = an n-by-1 data vector 
*>* * . 

b = a k-by-1 bias vector (see BIAS control card, table 13-1) 

To determine the type of rescaling to be done on the transformed 
data, the user must provide the RESCALE control card. (Control 
cards are listed in table 13-1.) Otherwise, the transformed data 
will be clipped at 0 and 255. To rescale the data, the following 
equation is used . 


Yf = K IMIN^ - Z^l (13-2) 

where 

= rescaled transformed data point for channel i 
Rjl_ = range of component i [MAX^ - MIN^^] 

MAXj_ = maximum value for component i 
MlNj[ = minim.um value for component i 
Zj_ = transformed data point for channel i 


A 7 


13-1 


The user may obtain the parameters and MIN^ in one of three 
ways; the histogram method^ the statistical method, or user 
input. Figure 13-1 shows the functional flow of the DATATR 
processor. The method and control cards associated with each 
method are defined below. 


13.1.1 HISTOGRAM (DEFAULT) METHOD 

A histogram of a segment of the transformed image is performed to 
find the R^_ and MINj_ for ea n component of the transformed data. 
If the user-defined field is smaller than 2000 pixels, all pixels 
are used in the histogram; otherwise, the following formula is 
used to determine the line and sample increments needed to obtain 
2000 points for the histogram. 


/ MN 

“ " \ 2000 ) 

where » 


(13-3) 


a = increment (integer) 
M = number of samples 
N = number of lines 


In deriving an approximate range for the transformed dat^ the 
user may specify a percentage of points to be excluded from the 
upper and lower tails of the histogram by using the PEROUT con- 
trol card. If not so specified, 2.5 percent of the points on 
each end of the distribution are excluded when determining the 
MAXj_ and MINj_ values of the central 95 percent of the transformed 
data distribution. 


Optionally, the user may specify the maximum expected data value 
for each channel n of the input data vector x. Otherwise, the 
maximum data value for each channel is set at 255. 


13.1.2 STATISTICAL METHOD 

Activated by the RESCALE and MODULE FILE (or MODULE CARDS) 
control cards, the statistical method is applied to derive an 
approximate MAXj_ and MlNj_ value for each component i. Using the 


subclass statistics, 
equations (13-4) and 

an approximate Rj_ is computed using 
(13-5) . 


Let 

c . = MAX . ( 


(13-4) 

and 

5, = MINj 

(®i - '^°i) 

(13-5) 

where 





i =!,•••, m components of z 
j =!,••*, w subclasses 

= transformed mean of the i^^ component of subclass j 

k = an integer specified by the user (see LAM control card) 

3^ = standard deviation of the i^*^ component of subclass j com- 
puted from the transformed covariance matrix for subclass j 

The approximate range of each component will be 

^i “ “i “ ‘^i ' ^ ~ l,***,m (13-6) 

and MINj_ = (13-7) 

The complete transformation, including rescaling, to be performed 
on each pixel of the original ima^e is 

Yi = X 1 6. - (Bx + b. ) I 

where 

bj_ = i^^ element of the bias vector 6 


(13-8) 


Optional control cards that may be used in conjunction with the 
statistical method are SUBCLASS, LAM, PEROUT, OPTION ORIG, and 
OPTION TRANSP. Their functions, as well as those of other con- 
trol cards, are described in table 13-1. 


13.1.3 USER-INPUT METHOD 


The user may input his or her own scaling parameters by means of 
the OPTION SCAFAC control card or use input from a previous 
execution of DATATR in which the computed scaling parameters 

• MIN,.l were punched on cards using the OPTION PUNCH 


CON, (= 


^i 

control card . 


The transformed or transformed and rescaled data are output in 
either Universal or LARSYS II/III format. The option is con- 
trolled by the FORMAT control card. 

A line-printer plot of the histogram (frequency distribution of 
the transformed/rescaled data) is printed. If applicable, the 
MAXj_ and MIN^ are printed. 

13.2 INPUT FILES 

An MSS data file must be input to the DATATR processor. The 
assignment defaults to logical unit 11; however, by input of the .• 
DATA control card, the user may assign any available logical 
unit. (See table 4-1 for file assignments and section 3.1, Image 
Tapes, for further information on format.) 

13.3 OUTPUT FILES 

The transformed or transformed and rescaled data are output on 
the TRFORM unit (default: 14) in either Universal or LARSYS II/ 

III format. 


no 
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13.4 SCRATCH FILES 


The DATATR processor does not use scratch files . 

13.5 CARD INPUT 

All system card file input formats referred to in this section 
are defined in section 3. 

13.5.1 PROCESSOR CARD 

The keyword for the processor card is left justified beginning in 
column 1, thus, 

$ DATATR 

This keyword directs the system monitor routine to select the 
DATATR processor and initiates loading of routines used by 
DATATR , 


13.5.2 SPECIAL SYSTEM FILES 

The B-matrix file discussed in section 3. 2. 4. 2 must be input to 
this processor. The deck may be obtained from a previous execu- 
tion of SELECT. If a statistics file is to be used, it can be 
either a SAVTAP file or a module STAT deck. 

13.5.3 CONTROL CARDS 

Table 13-1 lists the control cards and available options for the 
DATATR processor. 

13.5.4 FIELD DEFINITIONS 

See section 3.2.3 for the format of field definition cards. At 
least one field definition card must immediately follow the *END 
control card. An output file is created for each field defini- 
tion input and is written on unit 14. Each of these fields con- 
sists of a rectangular field which encompasses the vertices of 
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17 


1 


the input field. All pixels within the rectangular output field 
but outside the input field are set equal to zero. The lines and 
samples will be numbered consecutively from 1. 


13.6 CARD OUTPUT 

The DATATR processor, via the OPTION PUNCH control card, outputs 
the computed scaling parameters on cards. Two pairs of scaling 
parameters are punched on each card; i.e., each punched card con- 
tains the scaling parameters for two components of the trans- 
formed data. The cards must be used in the same order as 
punched. Their formats and definitions are as follows. The num- 
ber of cards is determined by the number of components . 


Columns 

1-6 

11-17 

18-27 


28-37 


Format 

A6 

A7 

Al,F9 .3,F9 .3,A1 


Definition 


A1,F9.3,F9.3,A1 


OPTION 


SCAFAC= 


(C0N3_,MIN2_) where CON]_=255/R]_ , Rj_ is 
the range of component 1, and MINji is 
the minimum value for component 1. 
Parentheses must be input . 

(C 0 N 2 ,MIN 2 ) where CON2“255/R2, R 2 is 
the range of component 2, and MIN 2 is 
the minimum value for component 2. 
Additional pairs are recorded on 
succeeding cards . 


13 .7 RESTRICTIONS 

The system-related restrictions in section 24 apply to this 
processor . 


The maximum number of channels allowed is 30, and the maximum 
number of components in the transformed vector is 16. 
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13.8 DIAGNOSTIC MESSAGES 


Diagnostic messages for the DATATR processor are listed by 
subroutine in appendix I. 
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TABLE 13-1.- CONTROL CARDS FOR DATATR 


Parameter and 

Keyword (a) default values (b) 


Function 


B-MATRIX 


*END 


$END 


DATA 


Required cards 

CARDS or FILE CARDS indicates that the 

B-matrix is on cards imme- 
diately following. FILE 
indicates that the B-matrix 
is on file and initiates 
input of the BMFILE. 

Blank Signals the end of the 

control cards. 

Blank Signals the end of all card 

input for this processor. 


Optional cards 


UNIT=n , FILE=n n is the number of the For- 

Default: n=ll,m=l , tran logical unit to which 

the MSS data file has been 
assigned; m-1 is the number 
of files to be skipped on 
the unit. 


^The keyword must be left justified in card columns 1 through 10. 

“The parameter values are in card columns 11 through 72 (beginning 
in any column past 10). 
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TABLE 13-1.- Continued. 


Keyword 

BIAS 


RESCALE 


MAXPT 


Parameter and 
default values 

bi ,b2 , * • • fbf^ 

N*bi,Kbfj+l, • • * ,bj^ 

M < 16 

Default: bj_-0.0 


Blank 


• * • ,M)- 

k < 30 

Default; 255,255,... 


Function 

All b^'s are decimal 
(floating-point) numbers, 
separated by commas; they 
comprise the bias vector to 
be applied to the transfor- 
mation of the input data 
set ; 

z = Bx + b 

N or K is the number of 
times a certain bj_ is 
repeated . M is the number 
of components in the trans- 
formed data set. 

Initiates rescaling of the 
transformed data to the 
range of 0 to 255. If not 
present, the data are simply 
clipped at 0 and 255. 

Maximum expected value of 
MSS data for each channel . 
M’s are integers used in 
deriving an approximate 
range ( MINj^ ,MAXj_) of the 
transformed data set for 
the histogram method of 
rescai ing . 
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TABLE 13-1.- 


Continued . 


Keyword 

PEROUT 


MODULE 


MODULE • 


Parameter and 
default values 

N 

Default; N=5 


CARDS 

Default; If RESCALE 
is input, the histo- 
gram method is 
assumed . 


FILE 

Default; If RESCALE 
is input, the histo- 
gram method is 
assumed . 


Function 

An integer which specifies 
the percentage of points to 
be deleted from the extremes 
of the transformed data 
distribution in computing an 
approximate range for 
rescaling . For the histo- 
gram method of rescaling, 

N/2 percent is deleted from 
each of the tails of the 
histogram, leaving the cen- 
tral S5 percent. For the 
statistical method of 
rescaling, N percent is 
deleted from each of the 
tails of the distribution, 
leaving the central 
90 percent . 

Initiates reading of the 
module STAT file that must 
immediately follow this 
card; if rescaling is per- 
formed, it initiates the 
statistical method. 

Initiates reading of the 
SAVTAP file; if rescaling is 
performed, it initiates the 
statistical method. 


TABLE 13-1. ~ Continued. 


Keywotrd 

STATFILE 


SUBCLASSES 


LAM 




Parameter and 
default values 


Function 


UNIT«n,FILE°m 
Default; n*20,m«l 


S1/S2. • • * 
k < number of 
subclasses on 
SAVTAP <60 
Default; Statistics 
for all subclasses 
defined are used in 
calculating the 
scaling factors . 

N 

Default: N=2 


n is the number of the For- 
tran logical unit to which 
the SAVTAP file has been 
assigned; m -1 is the number 
of files to be skipped on 
the unit. 

(NOTE: If a module STAT 

file is input, m is the 
number of the file on which 
to store the training sta- 
tistics. If m 7 ^ 1, this 
control card must precede 
the module STAT deck.) 

Integers which define a 
subset of subclasses 
Si,S 2 ,*",Sk from the input 
statistics file (SAVTAP) 
to be used in calculating 
the scaling factors and 
approximating . 


sr 

u 

If 

r 

h 

k 



I 

! 


An integer multiplied by the 
standard deviations of the 
input subclass statistics to 
derive an approximate range 
for rescaling the trans- 
formed data . 


II 

11 


n 


I 


n 1 
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TABLE 13-1.- Continued. 


Keywocd 

OPTION 


OPTION 


OPTION 


OPTION 


TROUT 


FORMAT 


Pacamstec and 
default values 

ORIG 

Default; No statis- 
tics printout 


TRANSF 

Default; No statis 
tics printout 

SCAFAC=(C0N2/MINi) , 
(CON2fMIN2 ) t 
{CONi,MINi) 

Default: Histogram 

method of rescaling 


PUNCH 

Default; No cards 
punched 

UNIT=n,PILE=m 
Default: None 


OUTPUT=UNIVERSAL 
Default: LARSYS II/ 

III 


Function 

Initiates the printout of 
the origiuil (untransformed) 
statistics for the sub- 
classes input for the sta- 
tistical rescaling method. 

Initiates the printout of 
the transformed statistics. 

CON and MIN are floating- 
point values separated by a 
comma. Blanks between the 
two values are ignored. The 
scaling parameters should be 
ordered according to the 
transformed data vector 
components . 

Directs the program to punch 
the scaling parameters 
(CON£,MINj_) on cards. 

n is the number of the For- 
tran logical unit assigned 
to TRFORM; m-1 is the number 
of files to skip before 
writing TRFORM. 

The transformed data will be 
output in Universal format. 
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TABLE 13-1.- Concluded 


Keyword 



FORMAT 


Parameter and 

default values Function 

tpaiM— I ii n ii m i ■ i ii 


OUTPUT* LARS YS 
Default; LARSYS II/ 
III 


The transformed data will be 
output in LARSYS 11/111 
format . 


Ancillary cards 

HEDl, HSD2, DATE, COMMENT (see table 3-1) 






1 R-HATRIX (FIUE OR CARO / 

/ SETUPS \ 

MODULE STAT DECK 

V aecK; / 

( READ CONTROL CARDS ) 1 

(OPTICNALi 

i 

\ AND SET DEFAULT VALUES / 

1 


tOCTIONAL) 



TRANSFORMS DATA ISt 
2 ■ 8x + b 


USER OPTioN 
OF COMPUTING 
MIN ANO MAX 


igure 13-1 Functional fl-n* chart for the DATATR processor 
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14 . STATISTICS TRANSFORMATION PROCESSOR — TRSTAT 


The TRSTAT processor will read a SAVTAP file or card deck gener- 
ated by STAT or ISOCLS, perform a linear transformation on the 
means and covariances, and output the transformed statistics on a 
new file (fig. 14-1). The equation for the linear trarisformation 
of the means is as follows ; 

p' = Ap + b (14-1) 

where 

p' = a k-by-1 tran’^formed mean vector 
k < 16 

A = a k-by-n matrix (see section 14.4.2) 
n < 30 

p = an n-by-1 mean vector 

b = a k-by-1 bias vector (see card type 4, section 14.4.2) 

The equation for the linear transformation of the covariances is • 
as follows : 

K' = AKA*^ (14-2) 

where 

K' = a k-by-k transformed covariance matrix 
K = an n-by-n covariance vector 
a"^ = an n-by-k transpose of A 

14 .1 INPUT FILES 

A set of statistics must be input either from the SAVTAP file or 
by cards. (See STATFILE or MODULE control card, table 14-1.) 
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14.2 OUTPUT PILES 


The transformed statistics are output on a file in the SAVTAP 
format. (See section 4.1 and STATPILE control card.) 

14.3 SCRATCH FILES 

The TRSTAT processor uses no scratch files . 

14.4 CARD INPUT 

All system formats referred to in this section are defined in 
sections 3 and 14.4,2. 

14.4.1 PROCESSOR CARD 

The processor keyword is left justified starting in column 1, 
thus , 

$TRSTAT 

This card directs the system monitor routine to execute the TRSTAT 
processor and initiates loading of routines used by TRSTAT. 

14.4.2 A-MATRIX PILE 

The A-matrix file is composed of a transformation matrix and an 
additive bias vector. Its format is shown below. For additional 
information on the transformation matrix, see section 3. 2. 4. 2. 


Card type 

Columns 

Format 

Definition 

1 

1-8 

A8 

Keyword A-MATRIX 

2 

6-7 

12 

Number of linear combinations 


13-14 

12 

Number of channels 


17-80 

12 

Actual channels used combination* 


*The channels described irPsection 3.2,4.2 begin 

in column 18 . 


Card type 

Columns 

Format 


Definition 

3 

6-20 

E15.8 

Element 

(column 

1 of A-matrix 
1, row 1) 


21-3 S 

• 

E15.8 

Element 

(column 

2 of A-matrix 

1 , row 2 ) 

• 

* 


• 

60-80 

El 5. 8 

t 

Element 5 of A-matrix (Five values 
are entered on each card until the 
full matrix has been entered . ) 

4 

6-20 

E15.8 

Element 

1 of b-vector* 


21-35 

• 

E15 .8 

Element 

2 of b-voctor 

• 


• 

66-80 

E15 .8 

Element 

• 

5 of b-vector (Five values 


are entered on each card until the 
computer vector of N linear 
combinations has been entered . ) 


14.4.3 CONTROL CARDS 

Table 14-1 lists the control cards and available options for the 
TRSTAT processor. 

14.4.4 FIELD DEFINITIONS 

No field definition cards are input to TRSTAT. 

14.5 CARD OUTPUT 

The transformed statistics deck will be output in the same format 
as the module STAT card file. 


*Unlike the B-matrix described in section 3. 2. 4. 2, the A-matrix 
file contains the additive vector. 
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14.6 RESTRICTIONS 


The system-related restrictions in section 24 apply to this 
processor . 

The maximum dimension of the h-matrix is 16 by 30, and the maxi- 
mum number of elements in the additive h-veotor is 30. 

14.? DIAGNOSTIC MESSAGES 

Diagnostic messages for the TRSTAT processor are presented in 
appendix 1. 


TMLE 14-1.- CONTROL CARLS FOR TRSTAT 
Parameter and 

Keyword (a) default values (b) Function 

Required cards 


CHANNELS 

Ni,N 2/**’,N)^ 
k » number of matrix 


channels < 30 

A-MATRIX 

Blank 


*END 

Blank 

$END 

Blank 


N's are integer channel num- 
bers referring to the SAVTAP 
file. The number of chahnels 
requested from SiAVTAP must be 
equal to the number of chan- 
nels on the A-matrix file. 

Initiates input of the 
A-matrix and b-vector. The 
A-matrix card images imme- 
diately follow this card. 

Signals the end of the 
control cards . 

Signals the end of all card 
input for this processor. 


^The keyword must be left justified in card columns 1 through 10. 

*^The parameter values are in card columns 11 through 72 (beginning 
in any column past 10) . 


TABLE 14-1." Continued 


Keyword 
STATE I LE 


MODULE 

SUBCLASSES 


Parameter and 

default values Function 

Optional cards 


INPUT/UNIT*n ,PILE»m 
OUTPUT/UNIT-Jl ,FILES«S 
Default: n*20,ra*l^ 

A»20,s*l 


Blank 


n is the number of the For- 
tran logical unit to which 
the file containing the sta- 
tistics to be transformed 
has been assigned? m-1 is 
the number of files to be 
skipped on the unit? i is 
the number of the Fortran 
logical unit to which the 
transformed statistics are 
to be output? and s-1 is the 
number of files to skip on 
the unit before writing the 
SAVTAP file. 

Initiates input of the module 
STAT deck, which immediately 
follows this card . 


SjL,S 2 , * • • ,S]^ Transforms statistics for 

k < number of only subclasses Sjl,S 2 , • • • ,Sj^ . 

subclasses on 

SA\^AP <60 

Default: Statistics 

for all subclasses 

defined 


TABtE 14-1 


Concluded . 


Keyword 

OPTION 


Parameter and 

default values Function 

P,0,T P punches the transformed 

statistics? 0 prints the 
original statistics? and 
T prints the transformed 
statistics . 


Ancillary cards 

HEDl, HED2, DATE, COMMENT (see table 3-1) 


INPUT A-HATRIX FILE 



Figure 14-1.— Functional flow chart for the TRSTAT processor 







15. N-DXMENSIONM, HISTOGPJVM PROCESSOR — NDHI3T 


The NDHIST procehsoc computes an n-4 w^.u-tional hLstogram o£ areas 
of the MSS data file for which the ust 5? h«3 requested scatter 
plots. The user specifies pixel dimensions by the plotting 
channels. The histogrammed pixels are output on the NHSTUN file, 
which is written as an interface to the SCTPRL processor , 

15.1 PROCEDURES 

The number of channels (dimensions) used in his tog ramming is 
specified by means of the CHANNELS control card defined in 
table 15~1 . The plotting channels are the primary input chan~ 
nels. The color channels are for further delineation of the 
frequency in his tog ramming . 

When n is greater thftf. 2, the SCTRPL processor must be directed 
to reduce the dimensionality to 2 by means of a linear 
transformation . 

The order of the pixels on the output interface file is deter- 
mined by the plotting channels . The frequency of each such pixel 
is determined as a function of the color channels { if input) and 

the plotting channels . 

* * 

The color assignment for each scatter plot point may be set by 
the NDHIST or SCTRPL processor . If applicable, the color codes 
are output on the NHSTUN file . The color codes may be set using 
the following information. 

a . The original radiance values of the pixel (see CHANNELS con- 
trol card, table 15-1) . 

b. The mean vector of the cluster or subclass to which the pixel 
was assigned during clustering or classification . In exer- 
cising this option, the uset must input a classification or 
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cluster map (see MAPPIL control card , table 15-1) to this 
processor. To execute the SCTRPL processor, a SAVTAP file 
related to the MAPUNT must be input (see CHANNELS and 
STATE I LE €*'ntrol cards, section 16, table 16-1) , The sub- 
class or cluster numbers assigned to the pixel during clas- 
sification or clustering are stored on the NHSTUN file, 
passed to the SCTRPL processor, and used for retrieving tne 
means from the SAVTAP file , 

c . The mean vector of the test or training field from which the 
pixel was extracted (see OPTION MEANS . rd , table 15-1) . 

d . User-defined colors (see COLOR control card , table 16-1) . 

e. Prom any pass on the MSS data file when using multitemporal 
Landsat data (see CHANNELS control card , table 3.5-1) . 

The areas selected for his tog ramming are defined by test and/or 
training fields . The manner in which the fields are collected or 
grouped for histogramming is user controlled by input parameters . 
The data vectors may be histogrammed collectively at the class , 
subclass, or per-f ield level . The maximum number of fields input 
at any level is 200 , and the maximum number of unique data vec- 
tors accumulated at any level is 12 000 divided by one-fourth the 
number of plotting channels. 

A functional flow diagram of the NDHIST processor is given in 
figure 15-1. 

15.2 INPUT FILES 

An MSS data file must be input to the NDHIST processor . The 
assignment defaults to logical unit 11; however, by input of the 
DATA control card, the user may assign any available logical 
unit. (See table 4-1 for file assignments and section 3.1, Image 
Tapes, for further information.) Optionally, a classification or 
cluster MAPUNT file may be input (see MAPFIL control card) . 


15-2 


15.3 OU'fPtJT glEiES 


An NHSTUN file is always output. It is an interface to the 
SCTRPL processor and must be assigned to tape or disk. No file- 
skipping capability is available; the first file created is 
always file 1. (See HISPIL control card, table 15-1.) 

15.4 SCRATCH FILES 

The NDHIST processor dynamically assigns random access disk 
storage for the histogram counters, color codes, identification 
information, and (optionally) the pixel assignment from the 
classified or clustered image file (MAPUNT) . 

15.5 CARD INPUT 

15.5.1 PROCESSOR CARD 

The processor keyword is left justified starting in column 1, 
thus , 

$NDHIST 

This card directs the system monitor routine to select the NDHIST 
processor and initiates loading of all the NDHIST routines into 
the system. 

15.5.2 SYSTEM CARD FILES 

No special system card decks are required for the NDHIST 
processor . 

15.5.3 CONTROL CARDS 

Table 15-1 lists the control cards and available options for the 
NDHIST processor. 


15.5.4 FIELD DEFINITIONS 

The field cards, which immediately follow the *END control card, 
define the areas to be histogrammed, and the OPTION control card 
determines the level of histogramming . The fields may be ordered 
in one of four ways ; 

a. As input to STAT (section 8.4.4) 

b. As input to ISOCLS (section 9.5.4) 

c. As input to CLASSIFY (section 11.5.4) 

d. Individually, as input by the user (section 3.2.3) 


For example i 
*END 

CLASS WHT 

SUBCLASS WHTl 

(Field card 1) 

(Field card 2) 
SUBCLASS WHT2 

(Field card 3) 

CLASS NVWHT 

SUBCLASS NWHl 

(Field card 4) 
SUBCLASS NWH2 

(Field Cv*sr:d 5) 
SUBCLASS NWH3 

(Field card 6) 

(Field card 7) 

$END 


If the histogram is accumulated on a class basis, fields 1, 2, 
and 3 are histogrammed collectively and output as data file 1; 
and fields 4, 5, 6, and 7 are histogrammed collectively and 
output as data file 2. 


I£ the histogram is accuniulvitod on & subclass basia, tields 1 
and 2 are histogrammed collectively and output as data tile 1; 
tield 3 is histogrammed and output as data tile 2j field 4 is 
histogrammed and output as data file 3; field 5 is histogrammed 
and output as data file 4j and fields h and 7 are histogrammed 
collectively and Ovitput as data file 5. 

If the histogram is performed on a por-field basis, each field is 
histogrammed separately and output to a file, making a total of 
seven data files created . 

On a cumulative histogram, a maKimum of 200 fields may be input. 
See section 3.2.3 for format of the field definition card, 

15.6 CARP OUTPUT 

The NDHIST processor does not provide punched card output. 


restrictions 

The systom-rolatod restrictions in section 24 apply to this proc- 
essor. Other restrictions are as follows. 

a. A maKimum of 16 channels may be histogrammed. 


b. A maximum of 4 channels may be used for color codes. 
Q. The maximum of unique vectors to be histogrammed is 


- , 12 000 
" - 174 (number oH^hanners] 


(15-1) 


d. A maximum of 4000 words of storage is allowed for storing the 
MSS data. The equation for computing the maximum number of 
pixels is 


n < 


4000 

5T“¥F samples per scan ITneT 


(15-2) 


15,8 DIAGNOSTIC MESSAGES 


Diagnostic messages for the NDHIST processor are listed with 
explanations in appendix I. 


r* 

‘V 
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TABLE CCM-mOh CARDS FQR NDHIST 


Keyword (a) 
CHANNELS 


*END 


Parameter and 
default valuee (b) 


Function 


Re quir ed c ards 


PL0T«Ni,N 2, * ‘ ' fNj, 
I < 16 

C0L0R«M3^,Mn, 

J < 4 


^ ^ 


Blank 


The N's ara the channels for 
determining the position 
(PLOT*) of the piKela to be 
output on NHSTUN, If Ia>2, 

Nj_ is the sample location 

and N‘-> the line location on 

*« 

the scatter plot, it l'*2, 
the pixels must be trans- 
formed to two components in 
the SCTRPL processor? com- 
ponent 1 will define the sam- 
ple locvition and component 2 
the lino location, The M's 
are the channels for the 
color codes . If the COLOR 
channels airo input, the his- 
togram is a function of both 
the PLOT and COLOR channels ? 
if the COLOR channels are 
omitted, the histogram is a 
function of only the PLOT 
channels. (See section 16 
for further information . ) 

Signals the end of the con- 
trol cards . 


^The keyword must be left justified in card columns 1 through 10. 

^The parameter values are in card columns 11 through 72 (beginning 
in any column past 10) . 


i'ABLE 15-1. » Continued. 


Parameter and 

Keyword default values 


Function 


$END 


DATA 


MAPFID 


HISFII, 


OPTION 

OPTION 

OPTION 


Blank Signals the end o£ all card 

input for this processor . 


Optional cards 


UNIT»n,FILE=n 
Default: n«ll^ra«l 


n is the number of the log- 
ical unit assigned to the MSS 
data file; m-1 is the number 
of files to be skipped on the 
unit . 


UNIT“n,FILE«m 

au Ml « 


UN1T=N 

Default; N=*4 
GLASS 

Default: Field basis 


n is the number of the log 


*» T 


1 t M % W * -ism- Ml. 

uiij. w 




o-U -- 


MAPUNT file; m-1 is the num- 
ber of files to be skipped 
on the unit. (The order of 
the fields to be histogrammed 
must correspond to the order 
of the clustered or classi- 
fied fields on the input 


MAPUNT file.) 

N is the number of the log 
ical unit assigned to the 
NHSTUN file. 


Fields will be histogrammed 
on the basis of classes . 


SUBCLS Fields will be histogrammed 

Default; Field basis on the basis of subclasses. 

FIELD Fields will be histogrammed 

on a per-field basis. 
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TABIiE 15-1.- Concluded 


Keyword 

OPTION 


Parameter and 

default values Function 

MEANS The means of each field will 

be computed for the COLOR 
channels on the CHANNELS card 
and output on the NHSTUN 
file . 


Ancillary cards 

HEDl, HED2, DATE, COMMENT (see table 3-1) 
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16 . SCATTER PLOT PROCESSOR — SCTRPL 


The SCTRPL procesaot reads the NHSTUN file written by the NDHIST 
processor, determines the location of each unique data vector on 
the scatter plot, and outputs a spectral plot in Universal 
format . A scatter plot is created and output for each file 
stored on the NHSTUN. 

The location (lino and sample intersection) of each pixel on the 
two-axis scatter plot will bo computed using either the radiance 
values or two linear combinations of radiance values. (This 
option is controlled in the NDHIST processor by the CHANNELS 
control card , table 15-1 . ) 

If the data vector is to be transformed (see B-MATRIX control 
card, table 16-1), the following equation and conditions will be 
applied : 

y » Bx + G (16-1) 

where 

y » a 2-by-l vector 
B * a 2-by-n matrix 
n < 16 

X » an n-by-1 vector 
c « a 2-by-l vector 

If the transformed data are to be rescaled (see SCALE control 
card, table 16-1), the following equation will be applied; 

/HI. - L0.\ 

Y. =1-^^- ij.lMIN. -Z.l (16-2) 
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vrhere 


» rescaled transformed data value for cbanne.l i 

HI^ « an input parameter for the upper rescale limit for 
channel i 

LOj_ »* an input parameter for the lower rescale limit for 
channel i 

* range for channel i [MAXji - MIN^] 

MAXi « maximum value for channel i 
MINj_ » minimum value for channel i 

» transformed data point for channel i 

The scatter plot is created and output line by line . All the 
pixels belonging to a line, as determined by the second coord i~ 
nate of the pixel , are collected; and, in the sample location 
determined by the first coordinate, the color assignment and 
frequency of occurrence of each pixel are output as channels 1 
through n, where n is the channel number of the frequency. [See 
procedures for NDHIST processor (section 15.1) for definition of 
color assignments.) 

The user controls the dimensions of the output file by using the 
following input control cards, which are defined in greater 
detail in table 16-1 (the control cards for the SCTRPL processor) 
and table 15-1 (the control cards for the NDHIST processor). 
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Keyword 

Parameters 

SI3E 

XSI2*129 

SISE 

YSIS-65 

SI2E 

XHIGH*128 

SISE 

XLOW*0 

SISE 

YHIGH-64 

SISE 

YLOW»0 

CHANNELS 

PLOT«3,4,COLOR*5,6, 


In this case, the output file will contain 

a. 129 saraplfcc per line with a maximum data resolution of 128. 

b. 65 lines per file with a maximum data resolution of 64. 

G . 5 channels with channels 1 through 4 containing the color 

pixel (determined by channels 5, 6, 7, and 8 on CHaNnEuS 
control card) and channel 5 the frequency . 

The position of each point on the output file is determined by 
the radiance values of the plotting channels, 3 and 4. 

If a MAPUNT file containing the subclass or cluster numbers has 
been input to the NDHIST processor, either a SAVTAP file related 
to the MAPUNT file must be input (see STATFILE control card) or 
the user must input the color codes on cards (see COLOR control 
card) . 

Optionally, a line-printer pixel-frequency scatter plot will be 
output (see PIXPLT control card) . The frequency of occurrence or 
log of frequency of occurrence will be represented by a symbol 
(see SYMBOL control card). The location of the symbol on the 
plot will be determined by the radiance value of the pixel. If 
the data have been transformed, then the data must be rescaled to 
exercise this option. 
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k functional flow diagram of the SCTRPL processor is given in 
figure 16-1. 

16.1 INPUT FILKS 

The NHSTUN file created by NDHIST must be input. (See the HISPIL 
control card and appendix E for format of the NHSTUfJ tape.) 

The SAVTAP file created by the STAT or ISOCLS processor may be 
input. (See the STATPILE control card and section 4,1 for a 
description of the file.) 

16.2 OUTPUT FILES 

A multifile Universal- formatted tape or dislc containing the 
scatter plots (with color keys) '?ill be output, (See the SCTRUN 
control card and appendix H for file format.) 

16.3 SCRATCH Pir-ES 

The program dynamically assigns random access disk storage for 
scratch files. 

16.4 CARD INPUT 
16.4.1 PROCESvSOR CARD 

The processor keyword is left justified starting in column 1, 
thus, 

$SCTRPL 

This card directs the system monitor routine to select the SCTRPD 
processor and initiates loading of all the SCTRPL routines into 
the system . 
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16.4.2 SYSTEM CARD PILES 

The module STAT and B-matrix card files may be input. See 
section 3 for formats. 

16.4.3 CONTROL CARDS 

Table 16-1 lists the options and control cards for the SGTRPL 
processor , 

16.4.4 FIELD DEFINITIONS 

Field definitions do not apply to this processor. 

16 .5 CARD OUTPUT 

The SGTRPL processor does not provide punched card output. 


16,6 RESTRICTIONS 

In addition to the system-related resirietions in section 24, the 

following restrictions apply to this processor, 

a. If the color codes for the scatter plot tape SCTRUN are to be 
principal component (PC) colors, the user must ensure that 
the values are positive . 

b. The maximum dimension of the B-matrix is 2 by 16; the maximum 

number of elements in additive vector b is 16. 

G. The m-?Himum number of channels on the output tape SCTRUN is 5. 

Color codes are the first n - 1 channels; the frequency is the 
channel . 

d. The maximum number of channels selected from the SAVTAP file 
is 4 . 

e. The maximum size of the output tape SCTRUN is 200 samples per 
scan line and 200 lines. 




TABLE 16-1.- CONTROL 

CARDS FOR SCTPPL 

Keyword (a) 

Parameter and 
default values (b) 

Function 


Required 

cards 

*END 

Blank 

Signals the end of the 
control cards. 

SEND 

Blank 

Signals the end of all card 
input for this processor . 


Optional 

cards 

HISPIL 

UNIT*N 

N is the number of the logi- 


Defaults N*4 

cal unit assigned to the 
NHSTUt^ file. 

CHANNELS 

N 1 /N 2 / ’ ' * rNj 

Statistics for chese channels 


1 < number of chan- 

will be extracted from the 


nels on SAVTAP <30 

SAVTAP file? they must be a 


Default: First 

subset of channels on the 

• 

four channels from 
NHSTUN file 

SAVTAP file. 

STATFILE 

UNIT«n,FILE«m 

n is the number of the logi- 


Default: None 

cal unit assigned to the 



SAVTAP file; m-1 is the num- 
ber of files to be skipped 
on the unit. 

MODULE . 

Blank 

Initiates the input of the 


module STAT deck, which imme- 
diately follows this card . 


®The keyword must be left justified in card columns 1 through 10. 

'^The parameter values are in card columns 11 through 72 (beginning 
in any column past IG). 


TABLE 16-1. Continued. 


Parameter and 


Keyword 

default values 

B-MATRIX 

CARDS 

Default: 

None 

B-MATRIX 

FILE 

Default: 

None 

BVEC 

Ti,T 2 
Default ; 

H . 0 

SCALE 

XMAX=T 
Default : 

XMAX will 


be computed from the 
NHSTUN file.^^ 


SCALE XMIN=T 

Default: XMIN will 

be computed from the 
NHSTUN f ile 


SCALE YMAX=T 

Default: YMAX will 

be computed from the 
NHSTUN file.^^ 


Function 

The B-matrix is being input 
by cards . 

The B-matrix is being input 
by file. 

Elements of the additive 
vector to be used in the 
transformation; the T's 
are floating-point numbers . 

The upper limit for the 
transformation of the sample 
values (x-axis). Used when 
the B-matrix is applied in 
SCTRPL. T is a floating- 
point number. 

The lower limit for the 
transformation of the sample 
values (x-axis). Used when 
the B-matrix is applied in 
SCTRPL. T is a floating- 
point number. 

The upper limit for the 
transformation of the line 
values (y-axis) . 'Used when 
the B-matrix is applied in 
SCTRPL. T is a floating- 
point number. 


*^If one of the parameters XMAX, XMIN, YMAX, or YMIN is input, all 
four parameters must be input. 
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TABLE 16-1. “ Continued. 


parameter and 


Keyword 

default values 

SCALE 

YMIN-T 

Default; YMIN will 
be computed from the 
NHSTUN file.^ 

SCALE 

FILE 


SCALE 

RESCALE 
Default; No 
rescaling of the 
transformed data 

SI3E 

XSIS-N 

Default; 

XSlS-101 

SISE 

YSI2*N 
Default ; 

YSI3»101 

SISE 

XHIGH-N 

Default; 

XHIGH-IQO 


function 

The lower limit for the 
transformation of the line 
values (y-axis). Used when 
the B-matrix is applied in 
SCTRPL. T is a floating- 
point number . 

The scale factors will be 
computed from the NHSTUN 
file . 

The transformed data will be 
rescaled to the range of 
XllIGH, XLQW, YHIGH, and YLOW. 
(See SISE control cards.) 

The number of samples per 
line to place on the scatter 
plot output unit; N < 200. 

The number of lines to place 
on the scatter plot output 
unit; N < 200. 

The upper limit of the radi- 
ance values for the sample 
axis (x-axis) of the scatter 
plot; N < 255. 


°If one of the parameters XMAX/ XHIN, ymax, or YMIN is input, all 
four parameters must be input . 
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TABLE 16-1.- COrttjinued 


Keywocd 

SI3E 


SI3E 


SI3E 


PLOTAP 

BGKGND 

COLOR 


parametec and 
default values 

XLOW«N 

Default; XLOW-0 


YHIGH*N 

Default; YH1GH«100 


YLOW*N 

Default; YLOW»0 


UNIT»N 

Default; N»12 
N 

Default; N*255 

(mi) , (m 2 ) , • • • , (mp) 
or 

L*(mi) ,K*(raL+i) r 
‘ , (mp) 

P < 60 

Default; No user 
input of color 
codes 


Function 

The lower limit of the radi- 
ance values for the sample 
axis (x-axis) of the scatter 
plot? 0 < N < KHIGH. 

The upper limit of the radi- 
ance values for the line axis 
(y-axis) of the scatter plot? 
N < 255. 

The lower limit of the radi- 
ance values for the line axis 
(y-axis) of the scatter plot? 
0 < N < 255, 

N is the number of the logi- 
cal unit assigned to the 
spectral plot tap.e . 

If N»0, background will be 
black? if N=255, background 
will be white. 

mi«ni ,h .2 / • • ’ /n^ is the color 
assignment for cluster 1? 
m^sn^^ ,n 2 / • • * fU is the color 
assignment for’ cluster 2? 

,ng , • • • is the color 
assignment for cluster P. 

0 < n. < 255 and ii < 4 . L or 

— 1 — 

K is the number of times a 
given color assignment is 
repeated . 


TABr.E Concluded. 


Keyword 

PIXPLT 

PIXPIiT 


PIXPLT 


SYMBOLS 


Parameter and 

default values Function 


FREQ 

Default! Mo printer 
plot 


Line-printer pixel scatter 
plot of the frequency of 
occurrence will be printed . 


LOG 


RESCALE 

Default! No rescal- 
ing. XSIS«101; 
YvSlS»«101j the range 
for X-axis is 
XLOW+.HSIS-I? the 
range for y-axis is 
YLQW+YSX2-1 . 

Si,S2,* • • ,Sj. 
k V 32 
Default ! 

../»C,0,Q,0,0,Q,B,0 


Line-printer pixel scatter 
plot of the log of frequency 
of occurrence will be 
printed . 

The frequency of occurrence 
of the pi.xol for the line- 
printer scatter plot will be 
rescaled to ranges XHIGH, 
KLQW, YIUGH, and YLOW. XSIS 
will determine the number of 
bins on the x-axisj YSI3, the 
number of bins on the y-axis. 
(See SI3E control cards.) 

Character sot separated by 
commas, with a maximum of 
32 characters. The number 
of iBymbols/2 determines the 
number of bin levels . The 
first set of symbols is 
overprinted by the second 
set. A blank is not a 
legitimate character. 


Ancillary cards 

HEDl, HED2, DATE, COMMENT (see table 3-1) 


1 t'^l 1 


• i 

^ % 










17 . DOT DATA PROCESSOR — DOTDATA 


17.1 PROCEDURES 



In implementing procedure 1, the DOTDATA processor was added to 
the system to allow the user to label certain MSS data points 
corresponding to pixels (known as dots) . The main function of 
this processor is to output a file containing the dots of 
interest , This file is an interface for three processors , 

ISOCLS, LABEL, and DISPLAY. (Figure 17-1 shows the functional 
flow of the DOTDATA processor.) 

The dots are defined by field cards. Any subset of the 209 pos- 
sible grid points may be selected by the user . The dots may be 
labeled as the file is created or in the LABEL processor. It is 
not necessary that all the categories of interest bo defined in 
this processor . 

This processor actually produces two files . Type 1 dots (start- 
ing and labeling dots) are written on one file; type 2 dots (bias 
correction dots) are written on the other file. As a result, to 
change the type of a dot, the analyst must execute this processor 
again . 

By an OPTION control card, the user may request that the spatial 
and spectral information relating to each dot on the file be 
printed on the line printer . 

17.2 INPUT FILES 

This processor requires an MSS data file . The assignment 
defaults to logical unit 11; but by input of the DATA control 
card, the user may assign any available logical unit. (See 
section 3.1 for further information on format.) 
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17. J OUTPUT Fir.ES 


The unformatted DOTUNT files are output as an interface for the 
processors ISOCLS, LABEL, and DISPLAY. The default for DOTUNT is 
logical unit 19, (See appendix F for format of the tape.) The 
logical unit and file number can be controlled by the DOTFIL 
contrc5l card . 

17.4 SCRATCH FILES 

The DOTDATA processor does not require an additional scratch 
file . 

17.5 CARD INPUT 

17.5.1 PROCESSOR CARD 

The procQS-sor keyword is left jiistified. beginning in column 1. 
thus , 

$ DOT DATA 

This card directs the system monitor routine to select the 
DOTDATA processor and causes all the routines used by it to be 
loaded into the system, 

17.5.2 SYSTEM CARD FILES 

The DOTDATA processor does not use any special input files, 

17.5.3 CONTROL CARDS 

Table 17-1 lists all available options, along with their default 
values . 


17.5.4 FIELD DEFINITIONS 

The user defines by field card the grid points to extract from 
the MSS data file . The order of the field cards determines the 
order of the dots in the dot data file, DOTUNT . The analyst will 


neovi to Know the v^^sition o£ the dots to w?e£ine start veotors 
in ISOCI.S and to label or relabel the dots in LABEL. 

As the fields are defined, tne type for each dot is defined by a 
TYPE card. By option, the analyst may label each dot by a C1^\SS 
card. If this card is omitted, the unlabeled dots should be 
labeled by the control card DOTLAREL or excluded from the set by 
the control card EXCLUDE in the LAREL processor. 

An example of a field data set expected by this processor 
follows. All names on CLASS cards are rovid from columns 11 
through IS. 

*END 


TYPE 

1 



CLASS 

WHT (optional) 



LfvB 1 

* H A \ \ *li\V 

\ XU r XU i 1 \ XU ^ XU J / \ xyu f XU 1 

a % s\ 
\J,V 

J ^ ^ \ 

LAB2 

(10,10) ,(10,20) ,(190,20) 

(19 

dots) 

CLASS 

W^'?!tT (optional) 



LAB 3 

(10,10) ,(10,50) ,(100,50) 

(10 

dots) 

TYPE 

2 



CLASS 

WHT (optional) 



BIAl 

(10,10) ,(10,40) ,(190,40) 

(19 

dots) 

CLASS 

NWHT (optional) 



BIA2 

(10,10) , (10,70) ,(190,70) 

(19 

dots) 


$END 

Two files are written. File 1 contains 38 WHT dots, followed by 
10 NWHT dots? all of which are type 1 dots. File 2 contains 19 
WHT dots, followed by 19 N^-fHT dots? all of which are typo 2 dots. 

If the CLASS cards were omitted, file 1 would contain 48 
unlabeled type 1 dots. File 2 would contain 38 unlabeled type 2 
dots . 


In both cases, the reference numbers for the dots in file 1 
defined by the LABI field card are 1 through 19, the LAB2 field 
card reference numbers are 20 through 38, and the LAB3 reference 
numbers are 38 through 48. The reference numbers for the dots in 
file 2 defined by the BlAl field card are 1 through 19? and by 
the BIA2 field card, 20 through 38. 


If the LACIE dot input option is selected, there are no TYPE or 
CLASS card images . Each input card image has the form 



IX)T begins in column 1. The dot type (1 or 2) appears in col- 
umn 5. A category name appears in columns 8 and 9 (if one 
character, it should appear in column 8). In columns 11 through 
80, integer dot grid numbers specify individual dots. The 
correspondence is as follows : 


Dot grid number Sample Line 


1 

10 

10 

2 

20 

10 

• 

• 

H 



19 

190 

10 

20 

• 

10 

20 

• 

39 

• 

10 

30 

• 

209 

190 

110 
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The dot cards can appear as a separate £ile in the format 
described 'above , This choice is specified by the OPTION U n 
card, where n is the Fortran unit number of the file. Further 
information on the LACIE-formatted dot file format can be found 
in appendix K. 

17.6 CARD OUTPUT 

DOTDATA does not produce any card decks . 

17.7 RESTRICTIONS 

System restrictions, presented in section 24, apply to DOTDATA. 

17.8 DIAGNOSTIC MESSAGES 

Diagnostic messages for the DOTDATA processor are presented with 
explanations in appendix I. 




TABLE 17-1,- CONTROL CARDS FOR IX)TDATA 
Parameter and 

Keyword (a) default values (b) Function 

Required cards 


CHANNELS 

DATA»C]^,G2/ * • * 
k < 30 

Integer numbers, separated 
by commas, referring to the 
channels on the MSS data 
file . 

*END 


Signals the end of the 
control cards . 

$END 


Signals the end of all card 
input for this processor . 


Optional 

cards 

rsAfnx 
L/rv o.rv 

uNIT»n , FXLE*m 
Default; n«20,m*l 

n is the number of the For- 
tran logical unit assigned 
to the MSS data file; m-1 is 
the number of files to be 
skipped on the unit. 

DOTFIL 

OOTPUT/UNIT*n , FILE=m 
Default; n=19 /m»l 

n is the number of the For- 
tran logical unit assigned 


to the DOTONT file output by 
this processor; m-1 is the 
number of files to skip on 
the unit before writing the 
DOTUNT file. 


^The keyword must be left justified in card columns 1 through 10. 

^The parameter values are in card columns 11 through 72 (beginning 
in any column past 10) . 
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TABLE 17-1.- Concluded. 


Keyword 

OPTION 


OPTION 

OPTION 


Parameter and 
default values 

U n 

(normally n«29) 
Default; None 


LAG IE 


PRINT 

Default; No line- 
printer output 


Function 

n is the number of the For- 
tran logical unit assigned 
to the LAClE-formatted dot 
file . When this option is 
taken, the LAClE-formatted 
dot file is used in lieu of 
in-line dot cards , 

Dot input will be in LAC IE 
format; card images follow 
the *END card , 

Prints the noTUNT file 
information on the line 
printer . 


Ancillary cards 


HEDl, HED2, DATE, COMMENT (see table 3-1) 


SDOTDATA 



Figure 17-1.- Functional flow chart for the DOTDATA processor 





18 . CLUSTER LABELING PROCESSOR — LABEL 


TO aid the analyst in supervising the labeling of the statistics 
obtained from the clustering processor ISOCLS, a new technique/ 
the processor LABEL/ was implemented* 

Two procedures for labeling the statistics are provided — the 
k-nearest-noighbor procedure and the all-of-a-kind procedure 
(fig . 18-1) . 


The labels in the dot data file, DOTUNT, or in the previously 
labeled statistics file, SAVTAP, may be changed by control card 
input (table 18-1) and the updated file output again* Optionally 

(1) a conditional or mixed cluster map may be output to tape ; 

(2) unconditional cluster map may be output in the format accept- 

ClK,.;a.t7 \m\J Uli^ i*/*l*h*?iTJL2nki. ^ ^ w 

information about the relabeled DOTUNT may be output to the line 
printer; and (4) the statistics of the SAVTAP file may be output 
to the line printer * 


18,1 PROCEDURES 

A distance table containing the Lj_ or L2 distance between each 
type 1 dot ajid each cluster mean is computed . 

n 

L, ■ 2 lx. - u. 1 (18-1) 

^ t=i ^ 


where 

n = number of channels 

* i^^ element of the 

* i*^^ element of the 



dot vector 
mean vector 


(18-2) 
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Using the table as input to the k-nearest-neighbor procedure or 
the all-of-a-kind procedure, the processor labels the statistics 
generated during clustering . 

For the k-nearest-neighbor procedure, the labels of the k label- 
ing dots nearest to a given cluster are polled. The label of the 
majority of the dots will be the label of the cluster. Xf a tie 
occurs, then k - 1 dots are considered. 

For the all-of-kind procedure, all of the labeling dots within a 
cluster are polled. If all the dots are of one category, the 
cluster is given the label of that category. If the cluster con- 
tains labeling dots of more than one category, the label of the 
majority of the dots labels the cluster. If there are no label- 
ing dots within a cluster, the labeling procedure defaults to 
k-nearest-neighbor . 

Optionally, a conditional cluster map may be output. A cluster 
is tagged as conditional if the distance between the nearest 
identically labeled labeling dot and the mean of the cluster is 
greater than the analyst-input threshold value, t. 

Optionally, a mixed clc:ater map may be output. A cluster is 
tagged as mixed if the labeling dots within a cluster are of more 
than one category . 

Optionally, a labeled cluster map may be output in the format 
acceptable to the DISPLAY processor,. Information used in the 
thresholding procedure in DISPLAY is dummied . If thresholding of 
the clustered data is desired, it can be performed by exercising 
the conditional map option in this processor. 


18.2 INPUT FILES 


Either the statistics file (SAVTAP) from ISOGLS or STAT or the 
dot data file (DOTUNT) from DOTDATA must be input. If either 
labeling procedure is to be used, both of these files must be 
input. The cluster map file (MAPUNT) usually from ISOCLS must be 
input if all-of-a-kind labeling is selected. 

For complete descriptions of these files, see section 4.1, 
appendix F, and section 3.1, 

18.3 OUTPUT FILES 

Any of the following files may be output. 

a. Statistics file (SAVTAP) labeled by using one of the two 
labeling procedures 

b. Statistics file (SAVTAP) relabeled by control card input 

c. Relabeled dot data file (DOTUNT) 

d. A conditional cluster map 

e . A mixed cluster map 

f. A labeled cluster map (MAPTAP) in the format acceptable to 
the DISPLAY processor (see appendix D for this format) 

The following items can be output on the lino printer.* 

a. Summary of selected options 

b . Table of Lj^ or L 2 distances 

c. summary of the labeling dots within a cluster for the all-o£- 
a-lc.ind procedure 

d. Summary of the k labeling dots nearest to a cluster for the 
k-nearest-neighbor procedure 


e. Spatial and spev 2 tt\il inComativan about the relabeled IXW’NT 
file 

f. Means and awat'ivances of labeled oe relabeled statistics 
IB. 4 SCRATCH FIIiBB 

LAREt. does not require an additional scratch file. 

IB. 5 CARR IMPCT 

Eormats for all .system card input are vie fined in section 3.d. 
IB.B.l PROCESSOR CARD 

The processor keyword is loft jvistified startinq in column 1, 
thus f 

BhAREL 

This card directs the system monitor routine to select the EARRL 
processor and initiates loadinq of all the routines needed to 
execute this processor. 

1B.S.2 SYSTEM CARD PILES 

The lAREL processor does not use any special input decks. 

IB. 5, 3 CONTROL CARDS 

Table 18-1 lists all available options, along with their default 
values . 

18. S. 4 FIELD DEFINITIONS 

A field definition card and a MAPDNT file must be input if the 
all-of-a-kind procedure is selected, a conditional or mixed 
cluster map is output, or a DISPLAY interface tape is output. 
This field card defininvg tho area of the unconditional cluster 
map (input MADUNT) must be identical to the field card input to 
ISOCLS and used to create tho unconditional cluster map. 


18.6 CARD OUTPUT 


This processor does not produce cards. 

18.7 RESTRICTIONS 

General system restrictions apply to lABEIi . 

18.8 DIAGNOSTIC MESSAGES 

Diagnostic messages for LABEL are listed by subroutine in 
appendix I, 


TABLE 18-1.- CONTROL CARDS FOR LABEL 


Keyword ( a 

.- in w w 

*END 

SEND 

CHANNELS 

DOTPIL 

EXCLUDE 


Parameter and 

default values (b) Function 


Required cards 


Signals the end of the 
control cards. 


Signals the end of all card 
input for this processor. 


optional cards 


STAT*Aj^ (lA^f ' * ’ / Aj/ 
DATA»C3_,C2, • • • / Ck 
Default; I » all 
channels on SAVTAP 
file 

K « all channels 
on DOTUNT file 


A's and C's are integer num- 
bers, separated by commas, 
referring to the channels on 
the SAVTAP file and the 
DOTUNT file , respectively . 


INPUT/UNIT«n,PILE=m n is the number of the For- 

tran unit assigned to the 
input DOTUNT file; m-1 is the 
number of files to be skipped 
on the unit. 


ni,n2/‘ • * 

i < 250 

Default : No dots 

are excluded . 


{n^} are integer numbers 
referring to the dots on the 
DOTUNT file that are to be 
excluded in all calculations 
(e.g., dots within a DO/ DU 
area) . 


®The keyword must be left justified in card columns 1 through 10, 

^The parameter values are in card columns 11 through 72 (beginning 
in any column past 10) . 


TABLE 18-1.- Continued 


Keyword 



DOTFIL 


STATFILE 


MODULE 


STATPILE 


MAPFIL 


Parameter and 
default values 

OUTPUT/ONIT»n , PILE»m 
Default; None 


INPUT/UNlT»n , PILE»m 
Default; None 


Blank 


OUTPUT/UNlT=n , FILE=m 
Default; None 


INPUT/UNIT»n , FILE=m 
Default; nal6,msl 


Function 

n is the number of the For- 
tran unit assigned to the 
output DOTUNT file; m-1 is 
the number of files to skip 
before writing the relabeled 
DOTUNT file , 

n is the number, of the For- 
tran unit assigned to the 
input SAVTAP file; m-1 is the 
number of files to be skipped 
on the unit . 

Initiates the input of the 
module STAT file . The file 
must immediately follow this 
card . 

n is the number of the For- 
tran unit assigned to the 
output SAVTAP file; m-1 is 
the number of files to skip 
before writing the newly 
labeled SAVTAP file . 

n is the number of the For- 
tran unit assigned to the 
input MAPUNT file. (If exe- 
cuting back to back with 
ISOCLS, n must be 16.) m-1 

is the number of files to be 
skipped on the unit . 


TABLE 18-1.- Continued. 


Keyword 

MAPFIL 


MAPTAP 


DISTANCE 

DISTANCE 

SUNANG 


Parameter and 
default values 

OUTPUT/UNIT*n , FILE»m 
Default: n*16,m»l 


OQTPUT/UNIT»n , FILE»m 
Default: No DISPLAY 

interface file will 
be output . 


LI 


L2 

Default: Lj_ 

distance 

mi,m2r • • • 

Default: No Sun 

angle correction 
is applied . 


Function 

n is the number of the For- 
tran unit assigned to the 
output MAPUNT file? m-1 is 
the number of files to skip 
before writing MAPUNT. (If 
both types of maps are out- 
put, the conditional map is 
output on file mj the mixed 
map, on file m+1.) 

n is the number of the For- 
tran unit assigned to the 
output MAPTAP file. (If 
executing back to back with 
DISPLAY, n must be 2.) m-1 

is the number of files to 
skip before writing MAPTAP. 

The L 3 _ distance between the 
labeling dots and the cluster 
means is used . 

The L 2 distance between the 
labeling dots and the cluster 
means is used . 

{mjj^} are integer Sun angle 
numbers used in computing the 
Lj_ or L 2 distance. A Sun 
angle must be input for each 
acquisition of interest. An 
acquisition is assumed to be 
a four-channel pass . 
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TABLE 18-1.“ Continued. 


Keyword 


SUNANG 


PROCED 


NEAREST 


DOTLABEL 


Parameter and 
default values 


PILE 

Default; No Sun 
angle correction 
is applied. 

NAME 

Default; N*K-NEAREST 


K 

Default; K»1 


Category name, 
1^1 ,n2 , • • • ,n j 
j < 250 

Default; None 


Function 

Example; If the distance is 
computed using 16 channels# 
four Sun angles (mj_, m 2 # m 3 # 
and m^) must be input. 

Sun angles will be extracted 
from the DOTUNT file . 


NAME is an alphabetic word . 
NAME “ K-NEAREST (Use the k- 
neares t-ne ighbor procedure.) 
NAME » ALL (Use the all-of-a- 
kind procedure.) 

NAME ■ MANUAL ( Use the manual 
procedure of relabeling the 
DOTUNT or SAVTAP file.) 

K is the number of dots to be 
used in the k-nearest- 
neighbor procedure . K is an 
integer number < 11 . 

The DOTUNT file is labeled by 
this card . Category name is 
the label the analyst is 
assigning to the dots } . 
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TABLE 18-1.- 

Continued . 

Keywofd 

Parametee and 
default values 

Function 



The category name may be com- 
posed of a maximum of four 
charactervS. (n^ } are integer 
numbers, separated by commas , 
referring to the position of 
the dot on the DOTUNT file. 

OPTION 

EXIT 

This card allows the user to 


Default; The run 

exit the EOD-LARSYS run if 


continues . 

any label input to the proc- 
essor is not used to label at 
least one cluster . 

STALABEL 

Class name, 

The SAVTAP file may be manu- 


ni,n2,*** ,nj 

ally relabeled by this card. 


j < 250 

(n^ } are the numbers of the 


Default; None 

subclasses on the SAVTAP that 
are to be regrouped into 
another class. Class name is 
the name of the class to 
which hubclcssas (r.^1 are to 
be reassigned. The class 
name must match a name on the 
SAVTAP file. 

OPTION 

DOTS 

Spatial and spectral informa- 


Default; Relabeled 

tion about the relabeled 


DOTUNT is not 
printed . 

DOTUNT file is printed . 

OPTION 

STATS 

Means and covariances for 


Default; Statistics 

labeled or relabeled statis- 


not printed 

tics on the SAVTAP file are 
printed . 


TABLE 18-1.- Concluded. 


Keyword 

OPTION 

THRESHOLD 

OPTION 


Parameter and 

default values Function 


COND 

Default; None 
T 

Default ; T»25 .0 


MIXED 

Default: None 


A conditional cluster map 
will be output. 

T is the threshold parameter 
used in creating the condi- 
tional cluster map. T is a 
floating-point number. 

A mixed cluster map will be 
output . 


Ancillary cards 


HEDl, HED2^ DATE, COMMENT (see table 3-1) 
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19. INCORPORATION OP RECENTLY DEVELOPED AND FUTURE PROCESSORS 


The processors described in the following sections have been 
developed recently. The need for multi temporal MSS data and 
ground truth in applications of pattern recognition such as 
Procedure 1 prompted their development. 


Because of the wide applicability of these processors, they can 
be regarded as utilities for the rest of the EOD-LARSYS . 


Provisions have been made in the monitor routine to incorporate 
future processors as they become availahJle . Candidates for 
incorporation include: 

AMOEBA (Texas A&M clustering/classification program) 


CLASSY (NASA/JSC/LOGkheed clustsring/cla 


sification algorithm) 


EQUPRB (Equi-Probable Blocks classifier and distribution function 
estimator) 


MULBAY (Mulbitemporal Bayes classifier) 

PCG (Principal Component Greenness transformation program) 
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20 . DATA MERGE PROCESSOR — DAMRG 


20,1 DESCRIPTION 

DAMRG is a versatile processor which performs the following three 
types of merge operations; 

• Channel merge — Specified channels from selected MSS files are 
concatenated to provide a field image with more channels. 

• Spatial merge — Specified fields are added to the side or 
bottom of a given field to make a larger image. 

• Line merge — Specified scan lines from up to six images are 
stacked to make an artificial image. 

The channel merge is useful for preparing multiple-acquisition 
images, which can then be used for temporal analysis. It can 

that all are registered to the same base, such as a map or 
reference image . 

The spatial merge is useful for combining images of adjacent 
areas to make larger mosaic images. The processor requires that 
each input field have the same number of channels, but the 
analyst may specify the channels from each field. 

Line merging is useful for preparing certain composite images for 
special purposes. Lines must all have the same length; that is 
to say, they must all contain the same number of samples. The 
number of channels from each MSS file must be the same, but 
selection of the channels is up to the user. Certain very 
restricted types of line merging could also be performed with the 
spatial merge option, but line merging will handle the general 
case . 
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20 ,2 INPUT./QOTPUT 


This processor can take data from up to six files and merge them 
into a single file. However, only four tape drives are avail- 
able? hence, to merge six files, some of the files must be on the 
same tape . Since the output data are written to disk, there is a 
practical limit to the number and size of files that can be 
merged . 

DAMRG is different from other processors in that it allows no 
defaults for DATA input cards , These cards, as well as SUKANG, 
LINES, and CHANNELS cards, if needed , and field definition cards 
must be present and in correct order. The number and order of 
files to be merged are deduced from these cards , and the order is 
preserved as other control cards are read. However, omission of 
the DATA output card will cause default tc unit 11, file 1, so 
that the merged image can be used normally in subsequent 
processors. Control cards used by the DAMRG processor are listed 
in table 20-1. Diagnostic messages are presented in appendix I. 

Figure 20-1 is a functional flow chart for the DAMRG processor , 
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TABLE 20-1.- CONTROL CARDS FOR DAMRG 


Parameter and 

Keyword (a) default values (b ) 


Function 


DATA 


CHANNELS 


'END 


$END 


DATA 


FORMAT 


OPTION 


NCPASS 


Required cards 

INPUT/UNIT«n]_,FILE«mi Fortran unit numbers and file 

numbers, one card for each 
file, in order. 


‘1 
Blank 

Blank 


m. 


Channel numbers, one card for 
each file, in order. 

■ Signals the end of the 

control cards. 

signals the end of all card 
input for this processor. 

Optional cards 


OUTPUT/UNIT=n , FILE=m 
Defaults n=ll,m=l 

UNIVERSAL or 
LARSYS II/III 
Default: UNIVERSAL 

CHANNEL or 
SPATIAL or PSEUDO 
Default: CHANNEL 

N 

Default; N=4 


Unit and file numbers for 
output . 

Format of output data file. 


Merging option. 


Number of channels per 
acquisition . 


^The keyword must be left justified in card columns 1 through 10. 
^The parameter values are in card columns 11 through 72 (beginning 
in any column past 10) . 
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TABLE 20-1.- Concluded . 


Keyword 

NAGROS 

NLIN 

LINES 

OPTION 

SUNANG 

SUNANG 


Parameter and 
d efault values 

N 

Default: N*1 


* '’^NimFIL 
ANGGOR 

Default: No sun 

angle correction 

TAPE 


Function 

In SPATIAL option, number 
of fields to be abutted 
horizontally (number across) . 

In PSEUDO option, number of 
lines from each file . 

In PSEUDO option, scan line 
numbers for extraction from 
files 

Sun angle correction applied 
to output pixels . 

Sun angles extracted from 
input cards . 

Sun angles extracted from 
tape headers . 


Ancillary cards 

HEDl, HED2, DATE, COMMENT (see table 3-1) 


°If the scan line numbers will not all fit on one card, continue 
on subsequent cards , each card having LINS in columns 1 through 4. 


EXTRACT INFORMATION 
ONE FILE AT A TIME. 
WRITE TO DISK. 



Figure 20-1.— Functional flow chart for the 
DAMRG processor. 


21 . GROUND TRUTH DOT LABELING PROCESSOR — GTDDM 


21.1 DESCRIPTION 

The GTDDM processor labels the 209 LACIE dots on the basis of the 
converted ground truth file produced by the GTTCN processor (see 
section 22). It is a very specialized processor, tied to the 
specific dimensions of LACIE segments and the formats of LACIE 
dot files. 

GTDDM outputs a LACIE-formatted dot file (see appendix K) pro- 
duced from the converted ground truth file. The user may indi- 
cate the source of the dot types (Phase III, Transition Year, or 
input) . He or she may also provide a crop-code- to-category-name 
transformation . 

21.2 INPUT/OUTPUT 

Input files are in Universal image format; pixels are represented 
by code values instead of radiance values. 

Transition Year crop codes are used as defaults, as shown in 
table 21-1 (default for TRANS card) . Other code labels can be 
used in connection with the TRANS card . 

The masking operation divides dots into type 1 (labeling dots) 
and type 2 (bias correction dots). These types are integral to 
LACIE ‘s Procedure 1. The user may apply either the LACIE 
Phase III or the LACIE Transition procedure for assigning types 
(1 or 2) to dots or furnish a different set. 

This processor is controlled by the control cards shown in 
table 21-1. Diagnostic messages are given in appendix I. 

Figure 21-1 is a functional flow chart for the GTDDM processor. 
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TABLE 21-1,- CONTROL CARDS FOR GTDDM 


Paramefcei: and 

Keywotrd (a) default values (b) Function 

Required cards 

*END Blank Signals the end of the 

control cards. 

$END Blank Signals the end of all card 

input for this processor . 

Optional cards 

READ UNIT*n,PILE»iu n is the number of the Por- 

Default; n>--12,m»l tran logical unit to which 

the converted ground truth 
file has been assigned; m-1 
is the number of files to be 
skipped on the unit. 


®The keyword must be left justified in card columns 1 through 10 . 

*^The parameter values are in card columns 11 through 72 (beginning 
in any column past 10) . 


-2 



Keyword 

TRANS 


^5ASK 

MASK 

MASK 

DUMP 


TABLE 21-1.- Continued. 


Parameter and 
default values 

Category«n;^ ,r \2 
Default ; 

N«l,256 

W-99,99 

W«124,124 

S«100,100 

S-125,125 

B»101,101 

B«126,126 

R«102,102 

R»127,127 

P»103-103 

P»128rl28 

O»104,104 

0»129,129 

W*l,15 

S«16,30 

PHASE THREE 

TRANSITION YEAR 

INPUT==nj_,n2,“*,nj_9 

(17 cards) 

Default ; 

TRANSITION YEAR 

PILES=N 
Default; N=1 


Function 

Crop-code- to-ca tegory-name 
transformation. The category 
is denoted by a letter of the 
alphabet . Crop codes nj^ 
and n 2 are assigned to this 
category. Subsequent assign- 
ments override previous ones. 


Use the Phase III dot types . 

Use the Transition Year dot 
types . 

Input a type matrix (size 
17 by 19) where nj_ = 1 or 2. 


Number of dot files to be 
written . 
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TABLE 21-1." Concluded 


Keyword 

WRITE 


Parameter and 
default values 

UNIT»n,FILE«m 
Default: n«23,m«l 


Function 

n is the number of the For- 
tran logical unit to which 
the dot files will be writ- 
ten? m-1 is the number of 
files to skip before writing 
the dot f ile . 


Ancillary cards 

HEDl, HED2, DATE, COMMENT (see table 3-1) 







22 . GROUND TRUTH DATA CONVERSION PROCESSOR — GTTCN 


22.1 DESCRIPTION 

GTTCN is a specialized processor constructed to convert artifi- 
cial LACIE Accuracy Assessment images (392 samples by 351 lines) 
to standard LACIE segment images (196 samples by 117 lines) . 

After conversion, these one-channel image files contain a ground 
truth code number for each pixel. The assigned numerical codes 
are those used in LACIE to identify crops or types of ground 
cover . 

The input image contains six labeled pixels (two samples on each 
of three lines) for every one LACIE segment pixel. The user 
chooses a subset of the six to be used in the conversion, and the 
processor determines the label by majority rule. For example, in 
the following case. 


Ground truth pixel (subpixel) Corresponding label 


Ml 

M2 


30 

20 


M3 

M4 


40 

30 


M5 

M6 


40 

40 


if all six pixels are 

used 

(the default 

case) , 

the majority 

label 

would be 40. If the 

user 

specified only 

pixels 

1, 3, and 4 

by 


submitting the following card 

LABEL 1,0, 1,1, 0,0 

then the label chosen would be 30 (the majority of 30, 40, and 
30) . 

Originally developed for use in LACIE, this processor is also 
useful for any application requiring ground truth. Such ground- 
observed data are generally accessible at LARS. 
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22.2 INPUT/QUTPUT 


Both the incoming ground truth file and the converted file are 
written in Universal format . 

The cards shown in table 22-1 control this processor in the 
standard way. Diagnostics are shown in appendix I, h functional 
flow chart is shown in figure 22-1. The processor will normally 
be used in conjunction with the ground truth dot labeling proc- 
essor (GTDDM) . The GTDDM processor is described in section 21. 

Codes are not documented formally, but the LACIE Transition Year 
codes are given in table 21-1. 
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TABLE 22-1.- CONTROL CARDS FOR GTTCN 


Keywords (a) default values (b) Function 

Required cards 

*END Blank Signals the end of the 

control cards. 

$END Blank Signals the end of all card 

input for this processor. 


Optional cards 

Number of files to be 
converted . 


CONVERT FILES-N 

Default; N=1 

READ UNIT«n,FI.LE»m 

r v«^ 1 mmrn 1 

u B f ill*— ^ 


LABEL VECTOR* 

Ni.N2,N3,N4,N5,N6 

Default: Nj_*l for 

each i 

OPTION PRINT 

Default: No print 


n is the number of the For- 
tran logical unit to which 
an input tape has been 
assigned; m-1 is the number 
of files to be skipped on the 
unit . 

If Ni*l, that subpixel is 
used in labeling a pixel. 

If N£*0, that subpixel is 
not used . 

This card requests a listing 
of the crop codes for the 
209 dots. 


®The keyword must be left justified in card columns 1 through 10. 

^The parameter values are in card columns 11 through 72 (beginning 
in any column past 10) . 
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TABLE 22-1.- Concluded. 


Keyword 

WRITE 


Parameter and 

default values Function 

UNIT«n,PILE»m n is the number of the For- 

Default; n*12,m«l tran logical unit to which 

the converted ground truth 
file will be written; m-1 is 
the number of files to skip 
before writing the converted 
file . 

Ancillary cards 

HEDl, HED2, DATE, COMMENT (see table 3-1) 





23 . EFFICIENT CLUSTERING PROCESSOR — TESTSP 

The TESTSP processor is identic'il to the ISOCLS processor except 
that in this case the data are stored in packed form on the 
direct access file, thereby reducing disk storage requirements 
for this file by a factor of 4. The ISOCLS processor is 
described in section 9. 
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24. SYSTEM RESTRICTIONS 


EOD-LARSYS is limited in every processor to processing no more 
than 30 channels of data. The MSS data file (DATAPE) may have 
more then 30 channels, but for processing purposes a subset of 
those channels must be selected via the CHANNELS control card . 

A maximum of 60 categories, classes, or subclasses may be proc- 
essed. However, it may not be possible to process the maximum 
number of channels and subclasses in the same run. The arrays 
within the system are dimensioned variably according to user 
requests. The amount of storage available will not accommodate 
the arrays that are dimensioned (number of subclasses) by (number 
of channels) if both maximums are used. Restrictions under the 
STAT, SELECT, and CLASSIFY processors allow the user to compute 
approximately whether or not the numbers of channels and sub- 
classes selected are acceptable. When core storage requirements 
are exceeded, a diagnostic message is printed and the user must 
reduce his or her requirements to get a successful execution. 
Restrictions specific to individual processors are noted in the 
description of each processor. 

As a result of the virtual storage characteristics of the system, 
arrays can be enlarged at user request by the system maintenance 
group. Exploratory Investigations Section, Lockheed. 
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APPENDIX B 

LARSXS III FORMAT FOR AN MSS DATA TAPE 


This is the third version of the MSS data storage format used in 
Purdue's LARSYS . The only difference between the second and 
third versions of the format is one word in the header record. 
That difference is transparent to EOD-LARSYS. 

There are four types of physical records on the MSS data tapes. 
They are 


1. 

ID record — 

200 4- 

byte words 

2. 

Data record 

— long 

enough to hold one scan line of data 

3 . 

End-of-tape 

record 

— 200 4-byte words 

4. 

End-of-file 

record 

— IBM Standard 


An MSS data tape contains one or more data acquisitions con- 
sisting of an ID record, several data records, and an end-of-file 
record. After the last data record on the tape, an end-of-tape 
record and two end-of-file records are written on the tape. 

As used in this document, a "word” is defined to be 32 bits and a 
"byte" to be 8 bits. Further details regarding the physical 
records follow. 

B.l ID RECORD (200 4-BYTE WORDS) 

Word Format Description 

ID(1) I LARS tape number (e.g., 1, 17, 102) 

ID(2) I File number on this tape 


Word 


Format 


Description 


ID(3) 


ID{4) 


ID(5) 

ID(6) 

ID(7“10) 

ID(ll) 

ID(12) 

ID(13) 

ID(14) 

ID(15) 

ID{16) 

ID(17-19) 

ID(20-50) 


I 


I 


1 

I 

A(4A4) 

I 

I 

» 

I 

A(1A4) 

I 

I 

A(3A4) 

I 


Run number (8 digits aabbbbcc) 
aa — last 2 digits of the year data 
were acquired 

bbbb — running serial number for the 
year data were taken 
cc — uniqueness digits for runs that 
would otherwi’se have the same run number 

Continuation code 

ID(4) = 0 means the first line of data 
follows this ID record 
ID(4) ® X means that the data following 
this ID record are a continuation of an 
acquisition started on tape X 

Number of data channels (spectral bands) 
on tape (30 maximum) 

Number of data samples per channel per 
scan line 

Mission identification (16 characters) 

Month data were taken 

Day data were taken 

Year data were taken 

Time data were taken 

Altitude of aircraft 

Ground heading of aircraft 

Date data run was generated on this tape 
(12 characters) 

All zeros (may be changed later) 


Word 


Format Description 


ID( 51 ) 

R 

Iiower limit in micrometers of first 
spectral band on tape 

ID(52) 

R 

Upper limit in micrometers of first 
spectral band on tape 

ID(53) 

R 

The suggested value of "CO" calibration 
pulse 

ID(54) 

R 

The suggested value of "Cl" calibration 
pulse 

ID(55) 

R 

The suggested value of "C2" calibration 
pulse 

ID(56-200) 

R 

Repeat of ID{ 51-55) for ID(5) channels in 
order of appearance in data records 

ID(51-200) 

R 

0.0 if data channels do not exist 


B.2 DATA RECORD 

Each data record will contain one. scan line of data from ID(5) 
(see ID record) channels. The first half word (2 bytes) will be 
the record number. The second half word (2 bytes) will be the 
roll parameter, which is a number indicating relative roll of the 
aircraft for this scan line of data. If the roll parameter is 
-32 767, the data for the given line does not exist. If the roll 
parameter has not been calculated, it will be set to 32 767. The 
fifth byte will be the first data sample from the first channel. 
The data samples are ordered channel^^, sample — sample^jj 
channel 2 / sample 2 — samplej^; and so on through 1D(5) channels and 
ID(6) data samples per channel. A data record (scan line) will 
be ID(5) X ID(6) + 4 bytes long. 


All but the last 6 bytes in each channel will be scanner data. 
The last 6 are calibration data, in order of appearance; 


1. 

o 

o 

”0" or dark level 



2. 

VCq 

Variance of Cq 



3 . 

Cl 

Calibration source 

Cl 


4. 

VCi 

Variance of Cj_ 



5. 

C2 

Calibration source 

C 2 


6 . 

VC2 

Variance of C2 



where 




Ci 

a calibration value i 



VCi 

a calculated variance of calibration 

value i 

On 

good data 

records, all 8-bit 

data and 

calibration 


be integers in the range of 0 to 255 with no sign included in the 
8 bits. A sample data value of 0 to 255 is the result of the 
8-bit analog-to-digital conversion which produces the MSS data 
tape . 


B . 3 END-OF-TAPE RECORD (200 4-BYTE WORDS) 


Word 

Format 

Description 

ID(1) 

I 

LARS tape number 

ID(2) 

I 

File number on this tape 

ID(3) 

I 

Set equal to zero 

ID{4) 

I 

Continuation code 
ID(4) = 0 means end of data 
XD(4) = X means data in previous 
is continued on tape X 

ID(5-50) 

I 

All zeros (may be changed later) 

ID(51-200) 

R 

0.0 (may be changed later) 
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APPENDIX C 


UNIVERSAL FORMAT FOR AH MSS DATA TAPE 

This is an adaptation of the Universal data tape format as 

defined in the Earth Resources Data Format Control Book.* 

C.l GROUND RULES 

t 

The ground rules for the Universal format as accepted by all the 

processors within EOD-LARSYS are as follows! 

a . 8 bits » 1 byte . 

b. The header record is the first record on a tape. 

c. The header record is 3060 bytes long. 

d. Data following the header will be arranged by data sets, 

where a data set is defined as the ancillary data and all of 

the MSS data for one scan line for all active channels. 

e. ' Data sets will be recorded in variable length physical 

records, not to exceed 3000 bytes of information per record. 
Note, since 3000 bytes is not compatible with the word 
lengths of all computers, the computer generating the tape 
will add a sufficient number of fill zeros to the end of the 
data to make the, record length divisible by 32, 36, 48, and 

60 bits (180 bytes). Therefore, it is possible to have a 

physical record length of 3080 bytes, but under no condition 
will the actual data exceed 3000 bytes. 

f. Data sets will be packed into consecutive physical records of 
equal length. Under no condition will a data set begin in 
the middle of a physical record unless the data set can be 
completed in that record. If two or more records are needed 


*Vol. 1, Rev. A. NASA/ JSC Technical Report PHO-TR543, Philco- 
Ford Corp. | Houston ) , Mar. 1975, sec. 7. 


C-1 


for the data set, the data set will be divided, but under no 
condition will the data for an MSS channel begin in the 
middle of a physical record unless the data for that MSS 
channel can be completed in that record. Consequently, 
lengthy data sets will be divided so that the ancillary block 
and MSS data from an integral number of channels will be in 
one record and the remaining MSS data will follow in succeed- 
ing records with an integral number of channels per record. 
Fill zeros will be supplied at the ends of the records as 
required to satisfy the equal length constraint noted in e. 

g . All data in the header record and ancillary blocks will be in 
binary . 

h . The tape format will be as follows ; 

IRQ* 

Ancillary block j Data set 
MSS block j 

IRG+ 

Ancillary block j Data set 
MSS block j 

IRG 

EOF 


*IRG = inter-record gap. This always follows the header record. 

An IRG may appear between the ancillary block and the MSS block 
so that the recording of a data set requires more than one 
physical record? or a physical record may contain two or more 
data sets, not separated by any IRG. See ground rules above and 
data set description following for criteria det<?rmlning the 
placement of IRG’s. 


e,2 HEADER RECORD 


Although the header record is 3060 bytes long, only a portion o 
the information is pertinent to the system at this time. A 
general description of the data that are unpacked by the TAPHDR 
routine is as follows; 


Byte 

89 


90 

91 

92-93 

96-97 

100-101 

102 


103 


104 

105-106 


Description 

Processing flag; 

0 * raw data 

1 « processed data from computing system 
Number of channels in this job 

Number of bits per radiance value (currently 8) 

Address (within scan) of start of MSS data 

Number of MSS elements per scan within a 
single channel 

Physical record size in bytes (must be a multiple 
of 180 bytes) 

Number of channels per physical record 

(This field refers to the second and subsequent 

records within the recording of a data set. 

Bytes 1785 and 1786 give the number of channels of 
data in the first record of a data set. If the 
number of elements per channel is greater than 
3000, this field will equal 0.) 

Number of physical records per scan per channel 
(This field is used only when the number of 
elements per channel is greater than 3000 . 
Otherwise it is equal to 0.) 

Number of records to make a complete data set 
Length of ancillary block in bytes 


Byte 

107 


108-109 


110-111 


1778 

1785-1786 


Descciption 

Data order indicator; 

0 » MSS data ordered by channel 

1 » MSS data ordered by pixel 

Start pixel number 

(Number of the first pixel per scan on this tape 
referenced to original image. The first pixel in 
the original image is pixel 1.) 

Stop pixel number 

(Number of the last pixel per scan on this tape 
referenced to original image.) 

Number of data sets per physical record 

Number of channels in the first physical record 

uj. uaua 


1787-1788 Total number of bytes per scan per channel 


2201-2202 

Sun angle 

for 

pass 

1 

2203-2204 

Sun angle 

for 

pass 

2 

2205-2206 

Pun angle 

for 

pass 

3 

2207-2208 

Sun angle 

for 

pass 

4 

2254-2261 

Soil line 

for 

pass 

1 

2262-2269 

Soil line 

^or 

pass 

2 

2270-2277 

Soil line 

for 

pass 

3 

2278-2285 

Soil line 

for 

pass 

4 


C.3 DATA SETS 
C.3.1 ANCILLARY BLOCK 


The first block of a data set is the ancillary block. The length 
of the ancillary block is variable. The number of bytes is given 
i;i the header record . 


The first word (2 bytes) of every record is a counter giving the 
number of this physical record within the MSS data set. This is 
primarily intended for use in data sets that are longer than 3000 
bytes and therefore require more than one physical record. This 
word will always be "I” for the first record of a data set. 

Bytes 3 through 6 will contain the current GMT at the start of 
this data set recorded in tenths of a millisecond <, 

Bytes 7 through 70 will indicate channel status for this scan, 

1 byte per channel, where LSB = 0 indicates the channel is 
synchronized, and LSB = 1 indicates the channel is not in sync. 

Bytes T. and 72 contain the scan line number. This will be an 
arbitrary but sequential count for each scan line that appears in 
the data run . 

Bytes 73 through N will be dependent on whether this job contains 
raw or processed data. (See byte 89 in the header record.) The 
value of N will be given in bytes 105 and 106 in the header 
record and will always be equal to or greater than 70. If this 
job contains raw data, bytes 73 through N will contain the house- 
keeping data channel from the sensor, if one is available. A job 
containing processed data will, in addition to the 70 bytes of 
ancillary data already described, contain, at a minimum, the fol- 
lowing pieces of information: 

a. Latitude of the aircraft or of the center of the image from 
EREP* or satellite, in binary 

b. Longitude of th4 aircraft or of the center of the image from 
EREP or satellite, in binary 


*Earth Resources Experiment Package . 


c. Altitude in meters, recorded in binary 

d. Heading, in tenths of a degree 

e. Ground speed, in meters per second 

f. Roll — format specific to sensor 

g. Pitch format specific to sensor 

h. Yaw — format specific to sensor 

i . Sun angle 

Other parameters maj, be added, if required. The total length of 
the ancillary block is given in the header. 

C . 3 . 2 MSS BLOCK 

following the ancillary block in each data set will be an MSS 
block consisting of the MSS data from all of the active channels 
for one scan. MSS blocks within a data run will always contain 
the same number of MSS channels . Each MSS block will be the same 
number of bytes in length. If MSS data are not available to fill 
a block, fill i.eros will be added to make it the same length as 
preceding MSS blocks. 

MSS data having fewer than 8 bits per pixel will be right justi- 
fied in an 8-bit byte, with zeros added to the left. MSS data 
having more than 8 bits per pixel will be right justified in as 
many 8-bit bytes as necessary to hold the pixel, with zeros added 
to the left . 

If this tape contains raw data, the pulse-code modulated (PCM) 
sync words associated with the MSS data, if any, will be included 
with the MSS data on this tape . If this tape contains processed 
data, no sync words will be present. 


If thia tape contains raw imagery data, calibration data for each 
channel used in each scan will be included, in the same sequence 
in which the raw data appear in the data stream of the mission 
tape. If this tape contains processed imagery data, the appear- 
ance of the calibration data will depend on the specific sensor 
requirements . 

The combined length of the ancillary block and the MSS block will 
determine the relationship between data sets and physical 
records^ Some data runs may contain data sets i nich are so small 
that more than one can be packed into one physical record. 

Others may contain data sets which will require a whole physical 
record for each. Still others may contain data sets .hich are 
so long that each data set will require two or more physical 
records . 

The way in which a data set is packed into a physical ' record 
depends on the length of the data set. The ancillary block will 
always appear in the first physical record per data set. Follow- 
ing the ancillary block, as many complete channels in this data 
set will be recorded as will fit in 3000 bytes. If the data set 
is too long to be recorded ir. one physical record, the second and 
subsequent records will begin with the next active channel in the 
data set. 

If an MSS block is divided between records, the number of data 
channels in the first record may differ from the number of chan- 
nels in the second and subsequent records; however, the number of 
channels in all records after the first one in a data set will be 
the same. The number of channels in the first record and the 
number in the subsequent records will be given in the header 
record. In records after the first, if insufficient MSS data are 
available to allow all records to contain the same number of 
channels, fill zeros will be added to make all of these records 
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the same length. Finally, fill zeros will be added to either the 
first recoro or all of the subsequent records, depending on which 
is shorter, so as to make all of the records the same length. 


Within the context of EOD-LARSYS, pixels within a scan of data 
will be arranged by channel. The Universal format* will be as 
follows ; 


Line 1 


Line 2 


/ Channel 1 


Channel 2 


\ Channel 


M 


Channel 1 


Channel M 


Pixel 1 
Pixel 2 


Pixel N 

Pixel 1 
Pixel 2 


Pixel N 

Pixel 1 
Pixel 2 


.Pixel N 
Pixel 1 

Pixel N 
Pixel 1 

« 

‘ 9 

Pixel N 


*If this tape "contains raw imagery data, the PCM sync words, if 
any, associated with the data on the mission tape will be 
included with the data.. 
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APPENDIX D 


MAPTAP FILE E’ORMAT 

The file MAPTAP is output by the processor CLASSIFY. It contains 
the statistics used in classification; the training field, cate- 
gory, class, and subclass information; and the classified data. 

Each file consists of the following types of records: 

4 run header records 

I I field header record 
N data records 
1 end-of-field record 
1 end-of-run record 
1 end-of-file record 

All records are written using unformatted Fortran WRITE 
statements . 

D.l RUN HEADER RECORD 1 

WRITE ( MAPTAP ) ( DATE ( I ) ,1=1,2) ,BMFLG,BMC0MB,BMFEAT,N0CLS2 , 

N0FLD2 , NOS UB2 , NOFET2 , TOTVT2 , NOCAT , VARS Z 2 , 

( FETVC2 ( I > , 1=1 , N0FET2 ) 

Fortran name 


and dimension 

Description 

DATE ( 2 ) 

Date the classification was performed 

BMFLG 

Flag indicating B-matrix was used in 
classification 

BMCOMB 

Number of linear combinations in B-matrix 

BMFEAT 

Number of channels used in computing the 
B-matrix 

NOCLS2 

Number of classes 


Repeated for each 
classified field 
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Fortran name 
and dimension 


N0FLD2 

Number 

NOSUB 2 

Number 

N0FET2 

Number 

T0TVT2 

Number 

NOCAT 

Number 

VARS 22 

Size o 

FETVC2(NOFET2) 

Actual 


Description 
of training fields 
of subclasses 

of channels used in classification 
of vertices in training fields 
of categories 

: covariance for each -iubclass 
channels used in classification 


D.2 RUN HEADER RECORD 2 

WRITE ( MAPTAP ) (CATNAM(I) ,I=l,NOCATl) , (CLSMTX(I) 1=1 , N0CLS2 ) , 
(SUBNO(l) ,I=1,N0CLS2) , (SUBDES(I) ,I=1,N0SUB2) , 

( (PLDMTX(I,J) ,1=1,4) ,J=1,N0FLD2) , 

( (VERTEX(I,J) ,1=1,2) ,J=1,T0TVT2) , 

(SUBCAT(I) ,I=1,N0SUB2) , (CLSVv-2(I) ,I=l,NOSUB2) , 
(KATNO(I) ,I=1,N0CLS2) , (KEPPTS(I) ,I=1,N0SUB2) 

Fortran name 

and dimension Description 

CATNAM(NOCATl ) Category names (if available) 

NOCATl = number of categories if CATEGORY 
classifier was applied 
NOCATl = number of classes if STANDARD 
classifier was applied 

Class names 

Number of subclasses in each class 


CLSMTX(N0CLS2) 

SUBN0(N0CLS2) 

SUBDES(N0SUB2) 


Subclass names 


Fortran name 
and dimension 

FLDMTX(4,NOFLD2) 


VERTEX! 2, T0TVT2) 


SUBCAT (NOSUB 2) 


CLSVC2(NOSUB2) 

KATNO(NOCLS2) 

KEPPTS(NOSUB2) 


Description 

Training field information: 

1 — field name 

2 number of class to which field belongs 

3 — number of subclass to which field 

belongs 

4 — number of vertices in this field 

Vertices for all the fields; ordered 
( sample , 1 ine ) i,{ sample , 1 ine ) 2 r • ’ • / 

( sample , 1 ine ) .jotv2 

Contains the number of the category to 
which each subclass belongs 

Contains the number of the class to which 
each subclass belongs 

Contains the number of the category to 
which each class belongs 

Contains the total number of training 
field pixels in each subclass 


D.3 RUN HEADER RECORD 3 

WRITE (MAPTAP) ( (COVMTX(I, J) ,1=1, VARS Z2) ,J=1,N0SUB2) 

{ (AVEMTX(I,J) ,I=1,N0FET2) ,J=1,N0SUB2) 

Fortran name 

and dimension Description 

COVMTX(VARSZ2,NOSUB2) Original or B-matrix- transformed 

covariance matrix for all subclasses 

AVEMTX(NOFET2,NOSUB2) Wean vector for each subclass 
D.4 RUN HEADER RECORD 4 

WRITE (MAPTAP) ( (COVMTX(I, J) ,1=1, VARS Z2) ,J=1,N0SUB2) , 

(CON (I) ,I=1,N0SUB2) , (DET(I) ,I=1,N0SUB2) 
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Fortran name 
and dimension 


Description 


COVMTX( VARSZ2,N0SUB2) Modified Cholesky factorization of the 

covariance matrix for all subclasses 

C0N(N0SUB2) Natural logoritlim of determinant divided 

by a priori value squared 

DET(N0SUB2) Determinant of covariance matrix for each 

subclass 


D.5 FIELD HEADER RECORD 

WRITE ( MAPTAP ) ( FLDINF (I ) , 1=1 , 6 ) , PTS , LINES , FLDESC , NC , 

(VERTCS(I) ,I=1,NC) , (VERTCS(I+NC) ,NC=1,NC) 


Fortran name 
and dimension 

FLDINF (6) 


PTS 

LINES 

FLDESC 

NC 

VERTCS(2,NC) 


Description 

Rectangular coordinates surrounding the 
field classified: 

1 — line start 

2 — line stop 

3 — line increment 

4 — sample start 

5 — sample stop 

6 — sample increment 

Number of points in the rectangular field 
defined in FLDINF 

Number of lines in the rectangular field 
defined in FLDINF 

Name of the classified field 

Number of vertices in the classified field 

Vertices for the classified field; ordered 
( sample , 1 ine ) , ( sample , 1 ine ) 2 f • • • r 
( sample , line 
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D.6 DAT?^ RECORD 


WRITE(MAPTAP)ILINE, (IR(I) ,I»1,PTS) ,(VR(I) ,I»1,PTS) 

Fortran name 

and dimension Description 

ILINE Line number in reference to the MSS data 

tape 

IR(PTS) Subclass number to which each classified 

data point belongs 

VR(PTS) Likelihood that the point belongs to that 

subclass 

D.7 END~OF~FIELD RECORD 

An end-of-field record has the same format as a data record with 

ILINE = 0. 

D.S END-OF-RUN RECORD 

An ersd~of-run record has the same format as the field header 

record with PTS = 0 . 
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APPENDIX E 


NHSTUN FILE FORMAT 

The interface file written to the NHSTUN is output by the NDHIST 
processor and read by the SCTRPL processor. 

All records are written using unformatted Fortran WRITE state- 
ments. The header record is always the first file on NHSTUN. 


The format of NHSTUN is as follows : 


IDescription 

Total number of means computed 
NOFET2 divided by 4 


File 1 Header record 
EOF 

/ Record 1 
I Record 2 

Record 3 (optional) 

Data file 1 / 4 

Record 5 

Record 6 

Record 7 (optional) 
EOF 


Data file N EOF 


The contents of each record are as follows . 


E.l HEADER RECORD 

Fortran name 
and dimension 

TOTMNS 


E-1 




SIZE 


Fortran name 
and dimension 

N0FET2 

( FETVC2 ( I ) , I«1 , N0FET2 ) 

NCLRCH 

(CLRVEC(I) ,I»1/ NCLRCH) 

E .2 RECORD 1 

Fortran name 
and dimension 

NOFLD2 
NOSUB 2 

TOTVT2 

NOVEC 

E.2 RECORD 2 

Fortran name 
and dimension 

CLSVC2 

(SUBVC2(I) ,I=1,N0SUB2) 

( (FIELDS (I, J) ,1=1,4) ,J=1,N0FLD2) 
( ( VERTEX ( I, J) ,1=1,2) ,J=l,TOTVT2) 

E.4 RECORD 3 (OPTIONAL) 

Fortran name 
and dimension 

(MEANS (I) ,*=1,T0TMNS) 


Description 

Number of channels to 
histogram 

Actual channels to histogram 
Number of color code channels 
Actual color code channels 

Description 

Number of fields histogrammed 

Number of subclasses 
histogrammed 

Number of vertices 

Number of unique vectors 
histogrammed 

Description 
Class name 
Subclass names 
Field information 
Field vertices 

Description 

Mean statistics for input 
f iel ds 


preceding page blank not filmed 


E.5 RECORD 4 


Fortran name 
and dimension 

((PLOT(I,J) ,1-1, SIZE) ,J-l,NOVEC) 

E.6 RECORD 5 

Fortran name 
and dimension 

(ID(I) ,I=l,NOVEC) 


E.7 RECORD 6 

Fortran name 
and dimension 

(COUNTR(I) ,I=l,NOVEC) 


E-8 RECORD 7 (OPTIONAL) 

Fortran name 
and dimension 

(COLOR(I) ,I=l,NOVEC) 


Description 
Data vectors 

Description 

Class, subclass, and field to 
which the data vectors belong 

Description 

Number of occurrences of the 

« 

data vectors 


Description 

Color extracted from MSS data 
file 


PRECEDING PAGE BLANK NOT FILMED 



APPKNDIX P 
DOTUNT FILE FORMAT 


ThG file written on the DOTUNT is output by the DOTDATA proc- 
essor , The records are written using uncormatted Fortran WRITE 
statements. 


A tile is output £or each type of field. The file consists of 
the following records: 


Repeat for 
eoch type 


I Record 1 1 
Record 2 1 

I Record 3 
\ EOF 


Field information 


Data record 


In the context of Procedure 1, type 1 dots are used for cluster 
seeding and labeling? type 2 dots are used for bias correction of 
proportion estimates. 


F.l RECORD 1 

WRITE ( DOTUNT ) NOCAT , NOFEAT , NOFLD, TOTVRT , TOTDOT , NO.SUN , 
( C ATN AM ( I ) , I = I , NOCAT ) , S 1 2 E 


Parameter 

Dimension (words) 



Definition 

NOCAT 

1 

Number 

of 

category names 

NO FEAT 

1 

Number 

of 

channels 

NOFLD 

1 

Number 

of 

fields 

TOTVRT 

1 

Numb*-;r 

of 

vertices 

TOTDOT 

1 

Number 

of 

dots 

NOSUN 

1 

Number 

of 

Sun angles 


F-1 


I 

[ 


paramo tor 

Dimonaidn (words) 

Definition 


CATNAM 

NOCAT 

Array containing the 

category 



names 


SISK 

1 

4 + NOFEAT 


F . 2 RECORD 

A 



WRITE ( DOTUNT ) ( PETVEC ( I ) , 1=1 , NOFEAT ) , 



( ( FLDSAV ( I, J) ,1= 

1,4) ,J=1,N0FLD) , 



( (VERTEXd, ") /I= 

1,2) ,J=l,TOTVRT) , 



(ANGLE(I) ,I d,NOSUN) 


Parameter 

Dimension (words) 

Definition 


PETVEC 

NOFEAT 

Array containing the 

channel 



numbers 


FLDSAV 

(4,NOFLD) 

Array containing the 

field 



description 


VERTEX 

(2,NOFLD) 

Array containing the 

field 



vertices 


ANGLE 

NOSUN 

Array containing the 

Sun angles 

F . 3 RECORD 

A 



WRITE (DOTUNT) ( (DOTS(I,J) , 1=1, 

SIZE) ,J=l,TOTDOT) 


Parameter 

Dimension (words) 

Definition 

DOTS 

(TOTDOT,SI2E) 

Array containing the 

dot 


information 

DOTS (1,1) = sample number for 
dot i 

DOTS (2, I) = line number for 
dot i 

DOTS (3,1) = type number for 
dot i 

F"2 

■v*,\ 


ParametQu 


Dimension (words) 


Dg finite ion 


DOTS (4, 1) = cateGgoi’Y number 

t. 

for dot i (optional) 

DOTS ( B , I ) 

• dote vector i 

■ 

D0TS(4+N0PSAT,I) 
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APPENDIX G 


DESCRIPTION OF CLUSTER IMAGE DISPLAY 
WITH COLOR KEYS 


APPENDIX G 


DESCRIPTION OF CLUSTER IMAGE DISPLAY 
WITH COLOR KEYS 


The cluster image data tape output by the ISOCLS processor con- 
tains the mean vector to which each corresponding pixel was 
assigned during clustering and a color key. The color key con- 
sists of n square images, each 10 samples by 10 lines in dimen- 
sion. Each color code square represents the moan vector for a 
given cluster. The color codes are ordered according to cluster 
number or greenness. The grcanness ordering (G) is a function of 
the four Landsat channels: 


>• = -0.29m-i m - 0.56u« + O.GOUt m 0.49w. 

1,N i,N 2,N J,N 4,N 


M 

= 4 Gi,N 


(G-1) 


where 

i = number ot pass 
N = cluster number 

= first channel of pass i 
^2 == second channel of pass i 
li^ = third channel of pass i 
= fourth channel of pass i 

M = number of passes for multitemporal Landsat data 

The number of color codes per scan line is computed by 

number of samples per scan line 
11 


G-1 


K 


(G-2) 


r' 


The numbOL* o£ lines coquirGd bo display bhe color codes is 
computed oy 

, _ (number ot* clusters - 1) , , . 

L = 0 , + 1 X 11 (u- 

The cluster field and color key are separated by a scan lino of 
zeros. Each color code square is separated from the next by a 
vertical line of zeros. 

The data are output in LARSYS II/III or Universal format (see 
appendixes B and C, respectively) . 

The structure of the file is as follows . 


HEADER RECORD 
Inter-record gap (IRG) 

N records — Mean vector for each corresponding pixel 


Record (N + 1) 


Record (N + 2) 


IRG 

Scan line of zeros 
IRG 

I » 

10 lines /color 0 color 
icode 1 • code 2 

• 

0 

10 samples 
IRG 


0 

0 

0 


0 

0 

0 color 

• code K 

• 

0 


* 

Record (N + L) — Color code (last cluster) 


EOF 


APPENDIX H 


SCTRUN FILE FORMAT 


APPENDIX H 


SCTRUN FILE FORMAT 

ThG seattGir plot image, written to the SCTRUN, containo two-axis 
eolor-codod spectral plot(s) and is output in the Universal 
format (appendix C) by the SCTRPL processor. Each file on SCTRUN 
contains ( 1) a single scatter plot image, of which N - 1 channels 
are color assignments and the N*^^ channel is the frequency 
channel, and (2) a color key, unless the color assignment is 
made up of the radiance values of each output pixel. 

The color key consists of n square images dimensioned 10 samples 
by 10 lines . A color code square is composed of the colors 
assigned to a given cluster . The color codes are ordered 
according to their cluster association ; i .e . , the color code 
associated with cluster 1 is output first, followed by the color 
code associated with cluster 2, etc . The number of color codes 
per scan line is computed by 


K 


number of samples per scan line 
11 


:h-i) 


The number of lines required to display the color codes 
computed by 


IS 




umber of clusters - 1) 
K 


+ 1 


11 


(H-2) 


The scatter plot image and color key are separated by a scan line 
of zeros . Each color code square is separated from the next by a 
vertical line of zeros. 

The dimensions of the output tape are user controlled via the 
control cards SIZE and CHANNELS (see section 16, table 16-1, and 
section 15, table 15-1, respectively), where the number of 
samples per scan line = XSIZ; the number of channels = dimensions 
of color pixel plus the frequency channel ; and the number of scan 
lines = YSIZ + L. 

H-1 


% 




A 


Tha sfeeac&uro ©£ thc5 fiilo io ao followo . 


YSIS records 


RGCOird (YSI3 + 1 


Record (YSIE + 2 


Record (YSI2 + 


HEADER RECORD 
IRG 

— Scatter plot image 

IRG 

or 

EOF (if color key io omitted) 
) — Scan line of zeros 

0 0 0 

0 0 0 

0 color 0 • • • 0 

• code 2 

• • • 

• f • 

0 ^ 0 0 

id samples 

IRG 

f 

Color code { last cluster) 


IRG 

( 

) — 10 lines ) color 
I code 1 

\ 



DIAGNOSTIC MESSAGES 


Al’fENDIX I 


DIAGNOSTIC 

I.l H IST - SUBROUTINE SETUPS 
Mosoaqo 

a . CHANNEL __ IS NOT ONE 
OF THE CHANNELS GIVEN 
ON CHANNELS CARD, 

b. TOO MANY CHANNELS ARE 

BEING HISTOGRAMMED AND 
PLOTTED ■— NO. OP CHAN- 
NELS WAS RESET 
TO . 

c. XHIGH - XLOW WAS LESS 
THAN 100. XHIGH WAS 
RESET TO XXX, OR XLOW 
WAS RESET TO XXX. 

d . ERROR ON DATA CARD . 

e. BAD SUPERVISOR CONTROL 
CARD. 

e. INVALID CARD — IGNORED. 


MESSAGES 


A channel ^n tn^ DISPLAY card is 
nob .a member •3*! the set of chan- 
nels on the CH/ NELS card . 

User requested too many histo- 
grams bo be plotted. The num- 
ber of histograms plotted varies 
according to the number of chan- 
nels histogrammed . 

Range of pixel radiances required 
to be >100 . 

Check unit assignment and file 
number . 

Check spelling of keywords. 

Inappropriate or defective card 
read . Make sure cards are 
punched correctly . 


1 . 2 GRA^'MAP 


1.2.1 SUBROUT PICT 

MG SO age 

a. THE NO. OP CHANNELS FOR 
THIS FIELD HAS BEEN 
REDUCED TO XXX SO ALL 
THE INFORMATION WILL PIT 
ON DISK. 

MAKE ANOTHER RUN TO 
GRAYMAP OTHER CHANNELS. 

b. FIELD TOO LARGE, 
TERMINATING. 

e. YOU HAVE ASKED FOR TOO 

MAXiv eAMnrt?e ipuE» f Aam 

SAMPLE IS . 

1.2.2 SUBROUTINE SETUP 6 

Message 

a. THIS CHANNEL IS OUT OF 
NUMERICAL RANGE AND WAS 
IGNORED. 

b. THIS CHANNEL IS NOT 
HISTOGRAMMED. 

c. ONLY 16 BINLEVELS 
PERMITTED. 

d. ERROR ON DATA CARD. 

e. BAD SUPERVISOR CONTROL 
CARD. 




Explanation 
Self-explanatory . 


Data exceed allocated storage. 
The last sample is reset to the 


Explanation 

All channels requested must 
be in the range 1 to 30 . 

Check CHANNELS control card 
and make sure all channels 
requested have been histogrammed . 

Reduce the number of bin levels 
to 16 . 

Check for format error and 
unit assignment . 

Check spelling of keywords. 
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I . 3 STAT 


1,3.1 SUBROUTINE SETUPl 
Message 

a. ///// PROM SUBR. SETUPl - 
BAD CONTROL CARD ENCOUN- 
TERED — INPUT CARD IS 
, 'CCCC ••• CCC 


b. *** STAT/SETUPl — 
ERROR IN OPTION (S) 
REQUESTED — SCAN OF 
OPTION (S) DISCONTINUED 
AT CARD COLUMN XX *** 


c. ERROR ON DATA CARD 

d. ERROR ON STATFILE CARD 


Explanation 

The input card read has none of 
the legitimate keywords to 
identify it as a recognizable 
control card. The faulty card 
is printed out as part of the 
message. Although the proc- 
essor will continue to read 
more control cards, this is 
an indication of an error in 
the deck, setup. The deck 
should be checked for proper 
control cards and proper 
sequence of cards . 

An OPTION control card is not 
acceptable to the processor. 

The scan of the options will 
be discontinued by the proc- 
essor, and any options speci- 
fied beyond the erroneous one 
will not be activated for the 
run. The processor continues 
by reading the next control 
card. (See section 3.2.2 
and table 8-1 for correct 
OPTION control card usage.) 

Check format and unit 
assignment . 

Check format and unit 
assignment . 


*** MAXSlBc^XK — MAX. 

NO. OP SUBCLASSES v^AN- 
NOT IW, OREATER THAN YY 
MAXSOB SETaYY PROCEHniNG 
TO NEXT OPTIONS iS) *** 


/////EHvJM SUBR. SETUPl — 
DECREASE OPTIONS ***** 
TERMINATING PROGRAM 
EXECUTION EROM SUBR. 
SETUP! ***** 


ThG maximum uubulauo numbop 
input on the OPTION MAXSUB 
control card oxceedo the maxi~ 
mum number o£ nubclaanoo that 
can be handled bv EOD-LARSYS. 

The processor will net the 
max im urn number of s u b c L a s n e r. , 
which will apply to oubclauBeu 
read in from the input uabclanu 
field definition tleck . 

The STAT procensor has run out 
of internal storaqe to handle 
the combination of the vjuanti- 
ties of input training fields, 
s u b c 1 a s s e s , a nd c h a n n e 1 s . 

Internal storage is fixed at 
10 600 locations. Each sub- 
class required roiu^hly 
1/2 (number of channels)" loca- 
tions for the subclass statis- 
tics. If histograms or spectral 
plots of subclasses and'^'or fields 
are requested, additional inter- 
nal storage is reouired. The 
options specified in the run deck 
(i.e., histograms and spectral 
plots) and possibly the quanti- 
ties of subclasses, channels, and 
training fields must be decreased 
or eliminated in order to get a 
successful run within the core 
storage limitation. 


MeooatjQ 


g . CHECK CHANNELS OR CLASS 
NOS. REQUESTED — • 

CANNOT BE LESS THAN OR 
EQUAL 0, OR GREATER 
THAN 30 

***** TERMINATING PROGRAM 
EXECUTION FROM 3UBR. 
SETUPl ***** 


1.3.2 SUBROUTINE LEARN 
Message 

***** STAT/LEAI^^ — MAX. 
OP XX SUBCLASSES EXCEEDED 
— FIRST XX SUBCLASSES 
USED — REMAINDER 
IGNORED 


b. ***** STAT/LEARN -- MAX. 
OF XX FIELDS EXCEEDED 
— XX FIELDS RETAINED 
FOR YY SUBCLASSES — 
REMAINDER OF INPUT 
TRAINING FIELDS NOT 
USED 


Explanation 

l£ the channel numbers opeci- 
fied on a HISTO or CHANNELS 
control card are not integers 
within the range 1 through 30, 
this message results. The 
processor halts after printing 
this message. Chock the format 
of the applicable processor con 
trol cards (see section 3.2.2 
and table 8~1) . 


Explanation 

The processor has read the 
maximum allov\/abre number of 
subclass names and associated 
training fields . The first 
MAXSUB subclasses and associated 
training fields input are com- 
puted and the remainder are 
ignored by the processor. 

The STAT processor has read 
the maximum allowable number 
of training fields. The 
available internal storage 
has been filled, and no further 
training fields can be accepted . 
Training statistics will be 
computed for the subclasses and 
fields which have been read to 
this point, and the remainder 
arc ignored by the processor , 
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1.4 ISOCLS AND TESTSP 


1.4.1 SUBROUTINES ISOCLS AND TESTSP 


Message 

a. NO. CHANNELS FOR STARTING 
NOT EQUAL THAT FOR 
CLUSTER. 

b. DIMENSION LIMITS EXCEEDED 

IN ISOCLS BY . 

REDUCE CHANNELS OR MAX. 
CLUSTERS . 

G. DIMENSION LIMIT OF 

FOR COVARIANCES EXCEEDED. 

1.4.2 SUBROUTINES PSPLIT AND 
Message 

ERROR READING DISK — 
ISTAT^XXXX . 


Explanation 

The number o£ channels of 
sta’^’ lng vectors from the STAT 
fil> ".<=t equal the number of 
req.,..,ted data channels. 

The user has exceeded storage . 

The number of channels or maximum 
clusters per class should be 
reduced . 

Same . 

PSP PAT 

Expxanation 

Operating system returns non- 
standard status from disk input 
output . 


1.4.3 SUBROUTINES RDDATA AND RDDPAT 


Message 

a. TOO MANY DO OR DU FIELDS. 
THESE IGNORED. 

b. TOO MUCH DATA REQUESTED — 
PIXELS * (CHANNELS + 1) 
CANNOT EXCEED 


Explanation 

There can be up to 10 DO fields 
and 10 DU fields. 

Disk file will not hold all of 
the data for one class . Reduce 
channels or size of fields . 


MGssaqe 


C. STORAGE REQUIRED FOR FIELD 
DEFINITION INFORMATION 
EXCEEDS THE DIMENSION 
LIMIT OF . 

d. END OP TAPE REACHED BEFORE 
END OF FIELD. 

e. INPUT ERROR — A CLASS 
CARD MUST BE INPUT BEFORE 
A GROUP OF FIELDS. 

£. NO. OF PIXELS TO BE 

UNPACKED PER SCAN EXCEEDS 
THE DIMENSION LIMIT OF 


1.5 SELECT 

1.5.1 SUBROUTINE AVEDIV 

Message 

a. REDUCED COVARIANCE MATRIX 
FOR CLASS XXX IS NOT 
POSITIVE DEFINITE. 

b. MORE STORAGE NEEDED IN 
SUBR. AVEDIV FOR WORK 
ARRAY — IWRKSZ=XXXXXXX . 

1.5.2 SUBROUTINE BHTCHR 

Message 

a. COVAR. FOR CLASS XXX IS 
NOT POSITIVE DEFINITE. 


Explanation 

All veL*tices, names, and 
rectangular coordinates are 
saved for each field. The user 
has exceeded storage . Reduce 
the number of fields. 

A field has been defined beyond 
the limits of the MSS DATAPE. 

See section 9.5.4 on defining 
classes and fields. 

Decrease the number of channels 
or pixels per scan line in the 
field . 


Explanation 

Check subclass/cluster statistics 
for singularity. 

Storage inadequate; adjust 
parameters . 


Explanation 

Check subclass/cluster statistics 
for singularity. 


Mas saga 

b. COVAR. FOR SUM OP CLASSES 
XXXX,XXXX IS NOT POSITIVE 
DEF. 

S. NOT ENOUGH WORK AREA 
AVAILABLE IN BHTCHR — 
IWRKSS^XXXXX . 

1.5.3 SUBROUTINE BSTGHK 
Message 

a. "BEST" XXX IS GREATER 
THAN OR EQUAL TO NO. OF 
FEATURES IN GIVEN DATA 
— IGNORED. 

b. INVALID EVALUATE 
REQUEST . 


1.5.4 SUBROUTINE DAVDNl 

Message 

ERROR ON DISK FILE — 

SUBR. DAVDNl -- ISTAT=XXX . 

1.5.5 SUBROUTINE DAVDN2 

Message 

MINIMUM IS AT ORIGIN -- 
PROGRAM CANNOT CONTINUE. 


E.xplanation 
Same as above . 


Storage inadequate ; adjust 
parameters . 


Explanation 

The channels included in "best" 
must be a subset of the input 
channels . 

The channels whose separabilities 
are to be evaluated must be a 
subset of total input channels. 


Explanation 

Tape hardware read error. 


Explanation 

Davidon-Fletcher-Powell itera- 
tion has reached an unusable 
minimum . 
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1.5.6 SUBROUTINE DAVDN3 


Massage 

*DAVDN3* — EITHER SIGYI OR 

YHY TOO CLOSE TO ZERO TO 

UPDATE H MATRIX — 

SIGYI =XXXXXXX .XXX.XXXX . 

YH Y=XXXXXXX . XXX.»XXX . 

1.5.7 SUBROUTINE DAVIDH 

Message 

a. NOT ENOUGH WORK AREA 
AVAILABLE IN DAVIDN — 
IWRKSZ=XXXXXX. 

b. ERROR ON DISK FILE — 
SUBR. DAVIDN == 

LSTAT=XXX . 

1.5.8 SUBROUTINE DIVERC, 

Message 

a. CO VAR. FOR CLASS XXXX IS 
NOT POSITIVE DEFINITE. 

b. NOT ENOUGH WORK AREA 
AVAILABLE IN DIVERG — 
IWRKSZ=XXXXX, 

1.5.9 SUBROUTINE GTSTAT 

Message 

NOT ENOUGH WORK AREA IN 

GTSTAT — IWRKSZ=XXXXX . 


Explanation 

Davidon-Fleteher-powell itera- 
tion cannot continue . 


Explanation 

Storage inadequate; adjust 
parartetors . 

Read error on disk file. 


Explanation 

Check subclass/cluster statistics 
for singularity. 

Storage inadequate; adjust 
parameters . 


Explanation 

Storage inadequate; adjust 
parameters . 
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1.5,10 SUBROUTINE SELECT 


Mies sago 

a. ERROR IN INPUT CHANNELS. 


b. CORE OVERFLOW IN SUBRAY — 
NN STORAGE LOCATIONS 
NEEDED FOR THIS PROBLEM. 


c. CORE OVERFLOW IN ARRAY — 
NN*2 STORAGE LOCATIONS 
NEEDED FOR THIS PROBLEM. 


1.5.11 SUBROUTINE SETUP4 
Message 

a. ERROR ON STATFILE CARD. 

b. TOO MANY EVALUATE 
REQUESTS — REMAINDER 
IGNORED. 


C. GROUP CARD IN ERROR -- 
IGNORED. 

d. PROGRAM CANNOT PROCESS 
LESS THAN 2 CHANNELS. 


Explanation 

User should review choice of 
input channels with respect to 
input parameters related to 
channels . 

User might reduce the number of 
subclasses or channels or try 
another procedure. The SUBRAY 
array is used for temporary 
storage in SELECT only. (See 
restrictions, section 10.6.) 

See suggestions for previous 
diagnostic message. The ARRAY 
is used throughout the system 
for variably dimensioned storage. 


Explanation 
Check format. 

The buffer to hold EVALUATE 
requests is dimensioned 100. 
The number of channels and 
channels to be evaluated for 
each EVALUATE request are 
stored in this array. 

Check format of GROUP option. 

At least two channels must be 
input . 



I-IO 


1 


Message 

e. PROGRAM CANNOT PROCESS 
LESS THAN 2 CLASSES. 

f. INVALID CONTROL CARD -- 
IGNORED. 

g . CORE NEEDED IN ARRAY FOR 
THIS PROBLEM IS XXXXXX 
WORDS . 

1.5.12 SUBROUTINE TRNDIV 
Message 

a. REDUCED COVARIANCE MATRIX 
FOR CLASS N IS NOT POSI- 
TIVE DEFINITE. 

‘ b. NOT ENOUGH WORK AREA IN 

) TRNDIV — IWRKS2=XXXXX. 

I 1.5.13 SUBROUTINE WGTCHK 

Message 

r SUBCLASS IS NOT AMONG INPUT 

SUBCLASSES — WEIGHT INPUT 
IGNORED. 

I 

1.5.14 SUBROUTINE WGTSCN 
Message 

^ a. SYNTAX ERROR ON WEIGHT 

CARD — REMAINDER OF CARD 
IGNORED. 

b. WEIGHT BUFFER IS FILLED — 
ONLY XXXXX CLASS NAME 

i 

PAIRS ALLOWED. 

[ 


Explanation 

At least two classes must be 

input . 

Cheek spelling oi keyword. 

Storage is inadequate; adjust 
parameters . 


Explanation 

The indicated covariance ma’trix 
cannot be inverted . 

Storage is inadequate; adjust 
parameters . 


Explanation 

Weights for every pair involving 
this subclass are ignored . 

Explanation 
Self-explanatory . 

Buffer storage is inadequate for 
all class name pairs . 


-11 

0 




1.5.15 SUBROUTINE WHRPLC 


MeGaat::iQ 

THE INCLUDE REQUEST FOR CHAN- 
NEL N IS NOT A LEGITIMATE 
REQUEST — IGNORED. 

1.6 CLASSIFY 
I.6..1 SUBROUTINE CLSFYl 
Message 

***** CLSFY/CLSFY2 — THE 
COVARIANCE MATRIX FOR SUB- 
CLASS XX IS EITHER SINGULAR 
OR NOT POSITIVE DEFINITE — 
THE DETERMINANT = XXXX.XXXX 
***** TERMINATING PROGliAM 
EXECUTION ***** 


Explanation 

The indiaated channel to be 
included is not among the input 
channels . 


Explanation 

The detGY.-minant ot each subclass 
covariance matrix is checked by 
CLASSIFY to see that it is a 
positive value. A zero value 
indicates a singular matrix, and 
a negative value indicates a non- 
positive definite matrix. If 
either condition occurs for any 
subclass covariance matrix to be 
used in classification, the proc- 
essor will stop. 

(NOTE; A probable source of an 
invalid covariance matrix is a 
module STAT deck which has been 
incorrectly formatted and thus is 
not producing good training class 
statistics. Another possible 
source is a SAVTAP file which 
does not contain valid statis- 
tical data.) 
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1.6.2 SUBROUTINE CLSPY2 


Message 

a. WIDTH OF RECTANGULAR 
FIELD SURROUNDING 
CLASSIFICATION FIELD 
CANNOT EXCEED 1000 POINTS. 


Explanabion 

The difference between the 
largest sample number of the 
classification field and the 
smallest sample number -of the 
classification field cannot 
exceed 1000. Reduce count of 
samples per scan lino. 


b . 


AS THE COMPUTER CANNOT 
EXPONENTIATE A NUMBER 
SMALLER THAN EXP (-88), 
XXXXXX PTS. WERE NOT CLAS- 
SIFIED IN THIS FIELD. 

TOO MUCH DA.TA REQUE'^TED. 


Self-explanatory . 


When too much data has been 
requested, (1) for the standard 
classifier, reduce parameters 
so that 


/ number of _ 

/number of _ 2\ 

Isubclasses / 

, subclasses 1 


^ /number of 'j + /points per \ 
\ subclasses/ \scan line / 


X 


/ number of \ . 
\channels / - 


12 500; 


or 


(2) for category classifier, 
teduce data so that the number 
of points per scan line x num- 
ber of channels < 12 500. 
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1.6.3 SUBROrJTINE REDIE2 


Mg 8 3 age 

a. ERROR OM CHANNELS CARD. 

b. **** CLSFY/REDIP2 — BAD 
CARD INPUT DETECTED ON 
ATTEMPT TO READ B-MATRIX 
INFORMATION AS DIRECTED 
BY CONTROL CARD . . . 

**** TERMINATING PROGRAM 
EXECUTION FROM REDIF2 **** 

C . **CLSFY/REDIP2 — B-MATRIX 
INPUT FROM BMFILE — BAD 
VALUES DETECTED: NO. COM- 

BINATIONS (BMCOMB) - 

, NO. CHANNELS 

(BMFEAT) = CHANNEL 

VECTOR (BMVEC) “ . 

***** TERMINATING PRO- 
GRAM EXECUTION FROM 
REDIF2 ***** 

d. ***CLSFY/REDIF2 — BAD 
CARD INPUT ON APRIORI CARD 
— DEFAULT A PRIORI 
PROBABILITY VALUES WILL 

BE USED. 

e. AT LEAST TWO (2) CATE- 
GORIES MUST BE ASSIGNED. 
EXITING FROM REDIP2. 

f. **** CLSFY/REDIF2 — BAD 
PROCESSOR CONTROL CARD 
**** TERMINATING PROGRAM 
EXECUTION PROM REDIF2 **** 


Explanation 

Cheek job ootup and unit 
asGignmonbo . 

The input B-MATRIX control card 
is printed out as part of the 
error message. One of the data 
cards following it is incorrectly 
formatted. Check deck oetup and 
B-matrix card file. 

Invalid data from the BMFILE have 
been deleted. 


Check format of APRIORI card. 


In exercising the category 
option, two or more categories 
must be used . 

Check spelling of keyword. 
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X.6.4 SOBROOtIflE SETFJP2 
MQOoagQ 

a. Ml ERROR HAS OCCURRED IN 
GROUPING CLASSES INTO 
CATEGORIES. CHECK THE 
FOLLOWING: 

NOT ALL OP THE CLASSES 
HAVE BEEN ASSIGNED TO A 
CATEGORY . 

A CLASS NAME ON THE CATE- 
GORY CARD HAS BEEN MIS- 
SPELLED. CLASS NAMES FROM 
SAVTAP PILE ARE; . 

CLASS NAMES FROM CATEGORY 
CARDS ARE: . 

b. USER-INPUT A PRIORI VAHJES 
DO NOT SUM TO 1.0. INPUT 
VALUES WERE NORMALIZED.** 

C. ** ERROR IN A PRIORI CON- 
TROL CARD. USER- INPUT 
VALUES IGNORED.** 

d. NO. OF CHANNELS REQUESTED 
FROM DATA TAPE AND MO. OF 
CHANNELS ON STAT FILE MUST 
BE EQUAL. 

1.7 DISPLAY 

1,7.1 SUBROUTINE DISTCV 
Message 

OVERFLOW. 


When an error oceuro in grouping 
slanoQs into eategorioo, either 
one or more claoo names (1) have 


not been asoigned or (2) have 
been mioopelled. The program 
lists the elasG names as sub- 
mitted from the SAVTAP file ©r 


the module STAT dock. Check 
these for errors. If neither 
(1) nor (2) is applicable, 
check the module STAT deck to 
assure that class names are 
left justified in the field. 


Self-explanatory . 


Check format of APRIORI card . 


Self-explanatory . 


Explanation 

Error flag set by CHIN indicates 
overflow condition . 
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CBROUTIME DISPLAY 


• 


Moss ago 

** DISPLAY ** FIELDS MUST LE 
DEFINED FOR SUBCLASSES FOR 
EMPIRICAL THRESHOLDS. 

1.7.3 SUBROUTINE DSPLYl 

Mg 8 sage 

NOT ENOUGH STORAGE FOR COVARi- 
MCE MATRICES — DSPLYl. 

1.7.4 SUBROUTINE DSPLY2 

Message 

a. DISPLAY WILL ACCEPT ONLY 
1000 PTS/SCAN LINE. 

b. **** DSPLY2/DOTSUM — 
DISCREPANCY IN DOT FILE 
INFORMATION **** 

NO. OF DOT CATEGORY LABELS 
MATCHING MAPTAP CATEGORY 
NAMES = XXXXXX. 

NO. OF DOT CATEGORIES IS 
GIVEN AS = XXXXXX. 

C. **** DSPLAY/DSPLY2 **** 

NO. OF DOTS - XXXXXX 
— EXCEEDS THE MAX. 
ALLOWABLE (250) **** 

DOT PERFORMANCE SUM- 
MARIES WILL NOT BE 
PRODUCED. 


ExplanafciQn 
elf-explanafeory . 


Explanation 
Adjust parameters. 

Explanatio n 
Adjust parameters. 

Check if correct dot file is 
used . 


Maximum number of dots exceeded. 
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1.7.5 SUBROUTINE EMTHRS 


ERROR BACK SPACING MAPTAP . 
ISTAT “ XXXXX. 


Hardv/ac<3 tape-read error 


1.7.6 SUBROUTINE FOIST 


Message 

FOIST — OVER LOW CONDITION 
IN FISHIN ROUTINE FOR 
SUBCLASS = XXXX. THRESHOLD 
SET TO 999 .999 . 


The FISHIN system subroutine 
has returned an overflow con- 
dition. The threshold value 
is set to 999.999 by the program. 


1-7.7 SUBROUTINE PRTSUM 


Message 

THE CROP NAME XXXX DOES NOT 
MATCH A CATEGORY, CLASS, OR 
SUBCLASS NAME. 

THE INTENSIVE TEST SITE SUM- 
MARY REPORT CANNOT BE PRINTED. 


Explanation 

Check spelling on CROP cards 


1.7.8 SUBROUTINE REDIF3 


Message 

**** DSPLY/REDIF3 — 
ERROR IN 'OPTION' CARD ' 
*r*** SCAN OP THIS CARD 
DISCONTINUED — PROCEED- 
ING TO NEXT CARD **** 


Explanation 

Check format and spelling of 
parameter . 
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Message 

***** fisher threshold 

REQUESTED — NOT PERFORMED 
— NO. SAMPLES FOR SUB- 
CLASS NAME (=N) IS LESS 
THAN OR EQUAL TO NUMBER 
OF CHANNELS (=M) . 

C . ERROR IN ACREAGE CARD — 
CARD IGNORED. 

d. *** A THRESHOLD VALUE IS 
OUTSIDE THE ALLOWABLE 
RANGE 0-1, THEREFORE 
NO THRESHOLDING HAS BEEN 
DONE IN THIS RUN *** 

xxxxx , xxxxxxxxx . xxxxx 

e. * ERROR ON SUBCLASS NAME 
CARD XXXX DOES NOT MATCH 

A SUBCLASS FROM THE MAPTAP 
FILE. 

f . * ERROR ON CLASS NAME CARD 
XXXX DOES NOT MATCH A 
CLASS^ NAME FROM THE MAPTAP 
FILE * 

g. INVALID CONTROL CARD — 
CHECK SPELLING OF KEYWORD. 


Explanation 

The program compares the number 
o£ samples to the number o£ chan- 
nels . If the number of sam- 
ples < number of channels, the 
threshold request is bypassed . 

Check format. 

Check format of THRESHOLD card . 
The first number is the cluster 
number . The second number is the 
threshold value for that cluster. 


Self-explanatory . 


Self-explanatory . 


Self-explanatory . 
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1.7.9 SUBROUTINE SETUP3 

Mossatjo 

a. ***** DISPLAY/SETUP3 — 

ERROR CONDITION ON ATTEMPT 
TO POSITION MAPTAP OVER 
_____ FILES ***** PSRSFL 

STATUS CODE " 

— ABORTING BUN ***** 


****** DISPLAY/SETUP3 — 
CORE OVERFLOW (TOP - TOP2 ) 
BY XXKXKX — EXECUTION 
TERMINATED ****** 

c. CLASSIFICATION BY CATEGORY 
(ON MAPTAP) IS REQUIRED IN 
ORDER TO PROCESS THE DOT 
DATA *** 

*** DOT PERFORMANCE 


Explanation 

The system coutine foe posi- 
tioning files (FSBSFL) has 
encounteeed difficulties in 
positioning MAPTAP to the 
correct file. The error 
occurred in the SETUP3 routine 
for DISPLAY. 

User should moke sure that the 
correct file number for MAPTAP 
has been indicated and that 
MAPTAP does in fact have the 
correct number of files. 

Subroutine SFOTUPS has computed 
the storage needed for the 
specific problem; if more is 
needed than is available, this 
diagnostic is printed. 

Procedure 1 uses category 
classifier only. 


SUMMARIES WILL NOT BE 
OUTPUT *** 


I . 8 DATATR 


1.8.1 SUBROUTINE LNTRAN 

Message 

a. *** THE NUMBER OF COMPO- 
NENTS IN Y-VECTOR TIMES 
THE NUMBER OP SAMPLES 
EXCEEDS THE SIZE OF 
STORAGE AREA — 

TERMINATING *** 

b. *** NUMBER OF CHANNELS 
TIMES NUMBER OF SAMPLES 
EXCEEDS 10 600 *** 

Q, ***** DATATR/ LNTRAN ***** 
ERROR ON INPUT FIELD DEFI- 
NITION CARD, FOR FIELD 
NAME XXXX ***** CONTINUING 
TO NEXT FIELD DEFINITION 
CARD. 

1.8.2 SUBROUTINE SETREM 

Message 

SETREM ERROR — THERE WERE XX 
SCALE FACTORS AND MINIMUM 
VALUES INPUT THROUGH THE 
SCAFAC OPTION. YY LINEAR 
COMBINATIONS WERE REQUESTED. 
THERE MUST BE A SCALE FACTOR 
AND A MINIMUM VALUE FOR EACH 
LINEAR COMBINATION. THE PRO- 
GRAM WILL TERMINATE THROUGH 
CMERR. 


Explanation 
Self-explanatory . 


Storage exceeded. Adjust 
parameters . 

Check format and parameters. 


Explanation 

This message indicates that the 
number of input scaling parameter 
pairs does not correspond to the 
number of components of the 
transformed data. Too many or 
too few pairs were input. 
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1.8.3 SUBROUTINE SETUPS 


Message 

a. *** BAD CONTROL CARD ™ 
DATATR/SETUP8 *** 

t,, ***** DATATR/SETUP8 ***** 

ERROR ON INPUT DATA CARD 
— CONTINUING TO PROCESS 
INPUT ***** 

***** DATATR/SETUP8 ***** 
ERROR ON INPUT STATE I LE 
CARD — CONTINUING TO 
PROCESS INPUT ***** 

d. *** INVALID CONTROL CARD 
REJECTED BY DATATR/ 

SETUPS *** 

1.9 TRSTAT 

1.9.1 SUBROUTINE SETUPS 
Message 

a. ERROR ON STATFILE CARD. 

b. NUMBER OF CHANNELS FROM 

STAT FILE DOES NOT EQUAL 
THE NUMBER OF CHANNELS ON 
A-MATRIX FILE. CHANNELS 
ON STAT FILE = . 

CHANNELS ON 

A-MATRIX = . 

c. *** BAD SUPERVISOR CONTROL 
CARD SETUPS *** 


Explanation 

Check spelling of keyword. 

Check control card, correct, 
and resubmit. 


Check control card, correct, 
and resubmit. 


Check spelling of parameter. 


Explanation 

Check spelling of keyword 
and parameters. 

Self-explanatory . 


Invalid control cara . Check 
spelling of keyword. 


Messa^;!a 


d. INVALID CONTROL CARD 

REJECTED SETUPS *** 

I.S.2 SUBROUTINE TRAMTX 
Mo s sago 

ERROR IN TRYING TO POSITION 
TRANSFORMED STAT FILE TO 
BEGINNING OF FILE XXX. 

1. 10 NDHIST 

1 . 10 . 1 SUBROUTINE ADORES 

Message 

TOO MUCH DATA REQUESTED. 
REDUCE NO. OF SAMPLES PER 
SCAN LINE AND/OR NO. OF 
CHANNELS . 

1.10.2 SUBROUTINE NDHSTl 

Message 

a. N VECTORS WERE NOT HISTO- 
GRAMMED, but USED IN 
COMPUTING FIELD MEANS, 

IF APPLICABLE. 

b. ERROR IN FIELD CARD. 
ABORTING. 


Explanation 

i I xi m i W iii ' i xl w aT.WHi i — .1| |<| » |||| ■I fnrm i< 

The pararaeteif field of the 
control card is in error. 


Explanation 

Check file assiwjnment. 


Explanation 
Self-explanatory . 


Explanation 

The histogrammed vector table 
is. full. N unique vectors wer 
not histogrammed. 

Check format and parameters . 


1.10.3 SUBROUTINE NDHST2 


Message 

CORE LIMITS EXCEEDED. MAXI- 
MUM NO. OF VECTORS ACCEPTED 
IS . 

1.10.4 SUBROUTINE RESTO 

Message 
ERROR READING DISK. 

1.10.5 SUBROUTINE SETIO 

Message 

a. ERROR ON CHANNELS CARD. 

b. ERROR ON DATA FILE CARD. 
C. ERROR ON DAS FILE CARD. 

d. ERROR ON N-DIM HISTOGRAM 
FILE CARD. 

e. ERROR ON OPTION CARD. 

f. INVALID CONTROL CARD — 
IGNORED, 

1.10.6 SUBROUTINE STODAT 

Message 

NOT ENOUGH DRUM SPACE TO 
STORE DAS TAPE DATA. 


Explanation 
Self-explanatory . 


Explanation 
Self-explanatory . 


Explanation 

Check parameter field of 
CHANNELS control card . 

Check parameter field of DATA 
control card . 

Check parameter field of MAPFIL 
control card . 

Check parameter field of HISFIL 
control card . 

Check parameter field of the 
OPTION control card printed out 
just above this message. 

Check spelling of keyword. 


Explanation 

Actually refers to the disk space 
used to store the MAPUNT file . 


I 

>4- • 
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I. 11 SCTRPL 


j 

I. 11.1 SUBROUTINE LINPLT 


Message 


A TOTAL OF 


POINTS WERE 


NOT DISPLAYED ON THE LINE- 
PRINTER GRAPH. THE POINTS 
WERE OUT OF RANGE OF EITHER 
THE X DIRECTION OR THE Y 
DIRECTION. 


Explanation 

Data may be rescaled to a 
resolution of 100. 


1.11.2 SUBROUTINE SETADR 


Message 

NOT ENOUGH DISK SPACE. 
TOTAL WORDS OF DISK 

bPAuC. = AAAAAAAAAAAA . 

TOTAL WORDS OF DISK 
SPACE AVAILABLE = 

xxxxxxxxxxxx . 


Explanation 


Adjust parameters. 


1.11.3 SUBROUTINE SETH 


Message 

a. ERROR IN POSITIONING 

NHSTUN FILE TO FILE 

b. ERROR ON N-DIM HISTOGRAM 
FILE CARD. 


c. ERROR ON CHANNELS CARD. 


d. ERROR ON STATFILE CARD. 


e. ERROR ON B-MATRIX CARD. 


Explanation 

Physical tape error occurred. 
Resubmit run . 

Check parameter field of HISFIL 
card . 

Check parameter field of 
CHANNELS card . 

Check parameter field of STATFILE 
card . 

Check spelling and parameter. 
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Explanation 


Message 

f . NO. OF PLOTTING CHANNELS 
AND NO. OP B-MATRIX CHAN- 
NELS MUST BE EQUAL. 

CHANNELS ARE AND 

RESPECTIVELY. 

g. ERROR ON SCALING CARD. 

h. ERROR ON TAPE SIZE CARD. 

i. ERROR ON SCATTER PLOT 
TAPE CARD. 

j . ERROR ON OPTION CARD. 

k. DATA MUST BE RESCALED 
BEFORE PIXEL FREQUENCY 
PLOT OPTION MAY BE 
SELECTED. 

l . INVALID CONTROL CARD ~ 
IGNORED. 

1.11.4 SUBROUTINE SORTIC 

Message 

ERROR IN SORTING VECTORS. 

1.11.5 SUBROUTINE VECSCN 

Message 

ERROR OCCURRED SCANNING 

VECTOR CARD. 


Number of channels to be trans- 
formed must equal the number of 
channels in transformed matrix. 


Check parameter field of SCALE 
cards . 

Check parameter field of SIZE 
card . 

Check parameter field of PLOTAP 
card . 

Check parameter field of PIXPLT 
cards . 

Transformed data must' be rescaled 
for line-printer plot. 


Check spelling of keyword. 


Explanation 
Self-explanatory . 


Explanation 

Check keypunching error on 
cards . 
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X.12 DOTDATA 


> 

1.12.1 SUBROUTINE DOTS 

Message 

**** NOTE — TOTVEC WAS 
GREATER THAN 250, THEREFORE 
TOTVEC WAS SET TO 250 **** 

1.12.2 SUBROUTINE SET13 

Message 

a. INVALID CONTROL CARD — 

IGNORED. 

b. ERROR ON DATA CARD. 

C. ERROR ON DOTPIL CARD, 

d. ERROR ON OPTION CARD. 


Explanation 

Total nurabec of dots allowable 
is 250 of type 1 and 250 of 
type 2 . 

Explanation 

Check spelling of keyword. 

Check parameter field. 

Check parameters. 

Check format and parameters. 


1.13 LABEL 

1.13.1 SUBROUTINE ALLKIN 

Message Explanation 

a. LABELING BY ALL-OF-A-KIND \ 

PROCEDURE , 

b . ** DEFAULTING TO K-NEAREST- , 

/Supervisory messages . 
NEIGHBOR PROCEDURE ** j 

C. A TIE OCCURRED. THE FOL- j 
LOWING DOTS WERE DISCARDED.^ 


1.13.2 SUBROUTINE FXLERD 

Message Explanation 

a. NOT ENOUGH CORE TO STORE Revise data par' v*s . 
DOT FILE. 
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Message 

b. NOT ENOUGH DISK SPACE FOR 
CLUSTER MAP INFO . 

1.13.3 SUBROUTINE KNEAR 

Message 

a. LABELING BY XXX NEAREST > 

NEIGHBOR PROCEDURE. | 

b. A TIE OCCURRED. THE , 

FOLLOWING DOTS WERE ' 

DISCARDED. j 

1.13.4 SUBROUTINE LABLR 

Message 

CATEGORIES HAVE NOT BEEN 

DEFINED. 

1.13.5 SUBROUTINE MANORD 

Message 

a. ERROR IN INPUT OF CLASS 
NAMES. NAMES ON STAT 
FILE ARE: 

b. NAMES INPUT ARE: 

1.13.6 SUBROUTINE SET14 

Message 

a. ERROR ON CHANNELS CARD. 

b. NO. OF STAT CHANNELS AND 
DOT DATA CHANNELS MUST 
BE EQUAL. 


Explanation 

Revise data parameteco. 

Explanation 
Supervisory messages. 


Explanation 

Check spelling and keywords on 
CATEGORY control card . 

Explanation 
Self-explanatory . 

Self-explanatory . 

Explanation 

Check format and parameters . 
Self-explanatory . 
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Mosogi^o 


C, ERROR 013 STATPILE CARD, 

d. ERROR ON MAPFIL CARD. 

«. USER HAS NOT INPUT ONE OF 
THE REQUIRED FILES: 

SAVTAP, MAPUNT/ OR DOTUNT . 

£. ERROR ON MAPTAP CARD. 

g. ERROR OK PROCEDURE CARD. 

h. A LABELING PROCEDURE MAY 
NOT BE CHOSEN WHEN UPDAT- 
ING THE DOTUNT OR SAVTAP 
FILE. 

i . ERROR ON OPTION CARD . 

j . INVALID CONTROL CARD — 
IGNORED. 

1.13.7 SUBROUTINE STOMAP 
Message 

NOT ENOUGH DISK SPACE TO STORE 

DAS TAPE DATA. 

1.14 DAMRG - SET18 
Message 

a. INVALID CARD — IGNORED. 

b. ERROR ON ABOVE INPUT 
CONTROL CARD. 


Expl anation 

«3— C— JfcK: , l"^r B '■ ll i l g. -W'‘'T»VI 

Check Coraat and parameter, o. 

Check SQpmat and paramo toes on 
both the MAPFIL and the DOTFIL 
card . 

Control cards missing. 

Check format and parameters. 

Check spelling and parameter. 

You may want to go through $LABEL 
again after files have been 
updated . 

Check parameter. 

Cheek spelling of keyword. 

Explanation 

A MAPTAP output unit should 
be assigned . 

Explanation 
Self-explanatory . 

Self-explanatory . 
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Mo 03 an 0 


S. ERROR n FIELD — OR SEND 
CARD MISSING, 

d. NUMBER OF CHANNEL CARDS — 
DOES NOT MATCH NUMBER OF 
DATA FILES . 

G. NUMBER OF SUN ANGLE 

CARDS — DOES NOT MATCH 
NUMBER OF DATA FILES _ 

f. NUMBER OF FEATURES 

ON — FILE — IS NOT 
EQUAL TO NUMBER OF 
FIRST PILE . 

g. FEATURES ADD UP TO A 

NUMBER GREATER THAN 
30 . EXITING. 

1.15 GTDDM 

1.15.1 ALPHA 

Message 

THE SYMBOL CANNOT BE USED. 

1.15.2 SET19 

Message 

a. INVALID CONTROL CARD — 
IGNORED. 

b. ERROR ON TRANSFORMATION 
CARDS . DEFAULT TRANS- 
FORMATION USED. 


ExplanablQn 

AfibGi* the *END eard, ab loast ©no 
£ield doEinibion eard maob appear. 

Self-Gxplanab©ry . 


EOD-LARSYS is restrieted to 
30 channels . 


Explanation 

The characters must be alphabetic . 

Explanation 
Self-explanatory . 

Self-explanatory . 


Self-explanatory . 


Self-explanatory . 
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MoGoaqo 


Q. ERROR ON READ TAPE CARD. 

d. ERROR ON WRITE PILE CARD, 

e. ERROR ON MASK CARD/// 
TRANSITION YEAR MASK USED. 

£ . ERROR ON CONVERT CARD . 

1.16 GTTCN - SET17 
Message 

a. INVALID CONTROL CARD — 
IGNORED. 

b. ERROR ON CONVERT CARD. 

c. ERROR ON OPTION CARD. 

d. ERROR ON WRITE TAPE CARD. 

I '17 UTILITY SUBPROGRAMS 
1.17.1 SUBROUTINE BUPILL 
Message 

XXXX BYTES EXPECTED. 

XXX BYTES ON RECORD. 


Explanation 

Either the word UNIT or the word 
S’lLE is missing from the READ 
control eard . 

Either the word UNIT or the v/ord 
PILE is missing from the WRITE 
control card . 

Self-explanatory. 

DUMP card is not written properly. 
The word PILE has been omitted. 

Explanation 
Self-explanatory . 

Self-explanatory . 

Self-explanatory . 

Self-explanatory . 


Explanation 
Self-explanatory , 


1.17 .2 SUBROUTINE CLSCHK 


a . 



** CLSCHK ** REQUESTED 
SUBCLASS NO. XXX IS NOT 
AVAILABLE IN INPUT 
STATISTICS FILE -- 
REQUEST IGNORED. 


b. ** CLSCHK ** REQUESTED 
SUBCLASS NO. XXX FOR 
GROUP NO. XXX IS NOT 
AVAILABLE IN INPUT 
STATISTICS FILE — 
REQUEST IGNORED. 



Either by the SUBCLASS control 
card or by default, a subclass 
number has been requested for 
use in classification which is 
greater than the largest subclass 
numoer available in the input 
training subclasses . The 
CLASSIFY processor ignores the 
requested subclass number and 
deletes it from use in 
classification . 


A subclass number input by either 
the SUBCLASS or the GROUP control 
'card is greater than the largest 
training subclass number avail- 
able. The requested subclass 
will be ignored in classification. 


c. ***** CLSFY/FETCHK — A channel requested on the 

CHANNEL XX NOT IN TRAIN- CHANNELS control card or in the 
ING DATA — TRAINING B-matrix input for use in clas- 

DATA CHANNELS ARE sification is not in the set of 

Cl ,Co ,C_ , • • • ,C„ . channels which was used to obtain 

training subclass statistics . 

The available set of channels is 
printed out as part of the diag- 
nostic message. Message d or e 
is added to this, d when the 
B-matrix is not involved and e 
when B-matrix channels are input. 
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MQssaqo 


***** 


CHANNEL XX IGNORED 


(NOT USED) IN 
CLASSIEICATION. 


***** 


B-MATRIX CHANNELS 


MUST BE EQUAL TO OR A SUB- 
SET OF AVAILABLE TRAINING 
DATA CHANNEI-S — THE INPUT 
B-MATRIX CHANNEL SET IS 


l£ tho B-matrix is not boinq 
input to the CLASSIFY pfocosooc 
(i.G., B-matrix ohannals are not 
involved) , the roquoatad channel 
causing the previous message will 
be deleted from the list o£ chan- 
nels and ignored by the CLASSIFY 
processor. In this case, mes- 
sage d is added to message c . 

If tho B-matrix is input to the 
CLASSIFY processor, the B-matrix 
channels become the set to be 
used in classification; and if 
one of tho B-matrix channels is 
not in the training subclass 
statistics, the processor can- 
not continue. In this case, 
message e will be added to 
message c . 


1.17.3 SUBROUTINE GMERR 
Message 


Explanation 


ERROR HAS OCCURRED. 


Self-explanatory . 
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1. 17,4 t5URR0UTINR CRDSTA 


MoeoatjQ 

EXCEEDED CORE LIMITS. REDUCE 
NO. OE TRAINING CLASSES OR 
FEATURES. EXITING FROM 
CRDSTA . 


1.17.5 SUBROUTINE DSTAPE 

Moss ago 

THE NUMBER OF CHANNELS TIMES 
THE NUMBER OF SAMPLES HAS 
EXCEEDED 11500. DECREASE THE 
NUMBER OF CHANNELS OR THE 
NUMBER OF SAMPLES. TERMINAT- 
ING RUN FROM DSTAPE. 

1.17.6 SUBROUTINE FLDINT 

Mesa ago 

a. FEATURE NUMBERS XXXXX AND 
ABOVE ARE NOT ON DATA 
TAPE. 

b. FIRST SCAN ON THIS TAPE 

IS NUMBERED XXXXXX . FIELD 
DEFINITION IN ERROR. 

G. NUMBER OF SAMPLES PER 

SCAN LIN'S ON THIS TAPE IS 
XXXXXX. FIELD DEFINITION 
IN ERROR. 


Explanation 

The combination of total number 
o£ channola, subclasaGo, and 
training fiields must be reduced 
to fit in the internal core 
storage available to the proc- 
essor. Total storage is 10 600 
locations . 


Explanation 

Storage available has been 
exceeded . 


Explanation 

User has requested a channel not 
on MSS DATAPE. 

Self-explanatory . 


Self-explanatory . 


MGssaqo 


d. THIS TAPE CONTAINS ONLY Self-explanatory 
XXXXXX CHANNELS. 


1.17.7 SUBROUTINE FSBSFL 


Messaqe 


Explana 


FSBSPL ONLY SKIPS FORWARD, 


Self-explanatory . 


1.17.8 SUBROUTINE FSFMFL 


Message 

FSFMFL ONLY SKIPS FORWARD. 


Explanation 


Self-explanatory . 


1.17.9 SUBROUTINE GETS'; 


Message 

a. ERROR IN POSITIONING 
UNIT XXX TO FILE XXX. 


Explanation 


Self-explanatory . 


b. REQUESTED SUBCLASS IS NOT Self-explanatory. 
ON STAT FILE. STAT FILE 
CONTAINS XXX SUBCLASSES. 


c. CHANNEL NO. XX IS NOT ON Self-explanatory. 
TRAINING STAT FILE. 

CHANNELS ARE 

Cl fC2 , • • • . 



1.17.10 SUBROUTINE GRPSCN 


Message 

///// FROM SUBR. GRPSCN — 
GLASS XXXXX INCORRECT — 

CLASS XXXXX IGNORED. CARD 
BEING SCANNED IS XXXX***XXXX. 


1.17.11 SUBROUTINE HISTGM 
Message 

TOO MUCH DATA REQUESTED — 
SAMPLE END WAS RESET TO XXXXX. 


Explanation 

One of the class numbers listed 
on the GROUP control card (1) is 
not in ascending order, (2) is 
greater than the largest class 
number allowable (30), or (3) has 
already been used in another 
group. The erroneous GROUP con- 
trol card is printed as part of 
the message. The processor will 
delete the erroneous class number 
from the list and proceed to 
group all other listed classes. 


Explanation 

The data for all channels for one 
scan line are unpacked into an 
array dimensioned 12 000. If the 
number of channels times [(sample 
end - sample begin)/sample incre- 
ment] exceeds 12 000, this diag- 
nostic is printed. Sample end is 
reset to fit the dimensions and 
execution continues . 
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1.17.12 SUBROUTINE HISTIG 


Message 

ONLY THE FIRST 50 FIELD 
DESCRIPTIONS WERE PRINTED, 
BUT ALL THE FIELDS WERE 
INCLUDED IN THE TOTAL 
HISTOGRAMMED STATS. 


1.17.13 SUBROUTINE I4A1BN 

Message 

EBCDIC TO BINARY INTEGER CON- 
VERSION ERROR AT CHARACTER 
XXXXX OF XXXXX CHARACTER 
FIELD; XXXX***XXXX. 

1.17.14 SUBROUTINE LABMAN 

Message 

ERROR IN POSITIONING SIG. 
EXTENSION TAPE TO FILE XXX. 
OUTPUT FILE NOT WRITTEN. 


Explanation 

The user has input more than 
50 fields, and only the first 
50 field descriptions will be 
printed in the "Data Blocks 
Histogrammed" portion of the 
total report; however, all the 
input fields were included in 
the calculations of the "Total 
Histogrammed Statistics." 


Explanation 

EBCDIC is the Extended Binary 
Coded Decimal Interchange Code. 


Explanation 
Self-explanatory . 


1.17.15 SUBROOTINE MEAD 
Message 

a. ERROR IN FIELD CARD. 
TERMINATING RUN. 


b. INCORRECT FIELD CARD. 
TERMINATING RUN. 

1.17.16 SUBROUTINE LINERD 

Message 

a. FIELD BOUNDARY FOR THIS 
FIELD DEFINED BEYOND SCOPE 
OF DATA. THIS FLIGHT LINE 
CONTAINS XKXXXX SCAN LINES. 

b. FLDINT MUST BE CALLED TO 
INITIALISE PARAMETERS FOR 
A NEW FIELD. 

1.17.17 SUBROUTINE RANK 

Message 

THE NUMBER OF CHANNELS ARE NOT 
A MULTIPLE OF 4. THE COLOR 
KEYS WILL BE ORDERED BY 
CLUSTER NUMBER. 


Explanation 

A ifield description card has an 
incorrect format . All vortices 
must be separated by commas and 
enclosed in parentheses, and 
sample and line numbers must bo 
integers. The card which caused 
the error is printed out with 
this message . 

Same . 


Exolanation 

- ■ 

User has requested scan line not 
on MSS DATAPE. 


For every field input there must 
be a call to FLDINT to reset 
parameters for positioning the 
MSS DATAPE. ■ 


Explanation 

Currently used greenness/ 
brightness transformations 
require four channels per pass . 
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1.17.18 SUBROUTINE RDDOTS 

Mgs sago 

a. CHANNEL XX IS NOT ON DOT 
FILE. CHANNELS ARE 

** 'S* 

b. DOT NO. .XXX IS NOT ON 
DOT PILE. FILE CONTAINS 
XXX DOTS. 

1.17.19 SUBROUTINE RDMEAN 

Message 

MEANS FOR CHANNEL XXXX ARE 
NOT ON FILE — DUMMY VALUES 
WILL NOT BE USED. 

1.17.20 SUBROUTINE RDMODK 

Message 

ERROR IN TRYING TO POSITION 
STAT FILE TO FILE XXX IN 
CRDSTA. 


1.17,21 SUBROUTINE REDDAT 
Message 

CHANNEL NO. XX IS NOT A 
TRAINING CHANNEL. XX TRAIN- 
ING CHANNELS ARE ,0^ , • • • ,C^ . 


Explanation 
Self-explanatory . 

Self-explanatory . 


Explanation 
Self-explanatory . 


Explanation 

An error occurred in position 
ing the SAVTAP file, and no 
statistics were written. 
Resubmit the run. 

Explanation 
Self-explanatory . 
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1.17.22 SUBROUTINE REDSAV 


Mo s a ago 

a. STAT FILE WAS NOT CREATED. 
EXITING FROM **REDSAV** 

b. ERROR IN POSITIONING STAT 
PILE TO PILE XXX. EXITING 
FROM REDSAV. 

G. USER HAS REQUESTED XX 

CHANNELS, XX SUBCLASSES, 
AND XX CLASSES. THIS 
COMBINATION OF STATS WILL 
NOT FIT IN CORE. PLEASE 
REDUCE REQUEST. 


1.17.23 SUBRaUTINE SEARCH 
Message 

a. SEARCHING FOR LINE. 

b. RECORDS PER SCAN, XXXXX . 
SCANS PER RECORD, XXXXX. 


An orroi' oeeurrod in positioning 
the SAVTAP file, and no statis- 
tics wore written . Resubmit run. 

Same . 


The fixed aaiount of internal core 
storage available to the proc- 
essor for storing class descrip- 
tions, number of subclasses in 
each class, subclass descrip- 
tions, field information, ver- 
tices, covariances, means, and 
working area has been exceeded . 
The total amount of storage 
available for the above informa- 
tion is 10 600 locations.* 

Reduce the requested combination. 


Explanation 
Self-explanatory . 
Self-explanatory . 


*The equation for computing the required storage is’ STORAGE = 
2(number of classes) + (number of subclasses) + 4(nuraber of 
fields) + 2( total number of vertices for all the fields) + 
(number of subclasses + 1)( (number of channels) (number of 
channels + 1 )/2] + ( number of subclasses) (number of channels) . 
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Mossaqe 


s. POUND IT AFTER XKX TRIES. 

Cl. FAILED AFTER XXX.XX TRIES 
— ABORTING. 

G. SCAN XXXXX IS MISSING — 
USING PREVIOUS SCAN 
INSTEAD. 

1.17.24 SUBROUTINE SETUP? 
Message 

a. ERROR ON CHANNEL CARD. 

b. ERROR ON DATA CARD. 

C. ERROR ON STATFILE CARD, 
a. ERROR ON DOTFIL CARD. 

e. INVALID INPUT — CARD 
_______ IGNORED. 

f . CHANNELS CANNOT BE CHANGED 
UNTIL THIS EXECUTION OP 
ISOCLS IS COMPLETED. 


Explanation 
Self-explanatory . 
Self-explanatory . 

Self-explanatory . 


Explanation 
Check format. 

Check format. 

Check format. 

Check format . 

Check table 9-1 for correct 
spelling of keywords for card 
input and make sure the keyword 
is left justified in the field. 

The channels to be used should be 
included in the first set of con- 
trol cards input after the ISOCLS 
card , That set of channels will 
be used for all classes . If the 
user attempts to input a CHANNELS 
card into the SETUP routine on a 
later entry, the card will be 
ignored . 
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MQSBaqo 


Explanation 


g. m. OF CLASSES CANNOT 
BE CHANGED UNTIL THIS 
EXECUTION OP ISOCLS IS 
COMPLETED. 


h. **WARNING** NMIN IS LESS 
THAN NO. OP CHANNELS, 
COVARIANCES WILL NOT BE 
INVERTIBLE . 

1.17.25 SUBROUTINE TAPHDR 
Message 

a. UNRECOVERABLE ERROR READ- 
ING HEADER RECORD. 

b. A LINE NO. IS LESS TEIAN 
OR EQUAL TO ZERO. 

c . LAST SCAN LINE READ XXXXX . 
ISTAT = XXXXX. 

d. INTERNAL DIMENSIONS TOO 
SMALL FOR DATA. NUMBER 

OF CHANNELS ON DATA TAPE = 
XXXXXXX. NUMBER OF 
POINTS/CHANNEL = XXXXXXX, 

e. DATA TAPE IS NOT IN 
UNIVERSAL OR LARSYS 
FORMAT . 


The number of classes to be 
clustered must be input only 
in the first set of control 
cards input after the ISOCLS 
card. If the user attempts to 
change this parameter, the input 
will be ignored . 

NMIN should be made greater than 
the total number of channels . 


Explanation 

Error occurred while trying to 
read header record . 

The first line number on the 
data tape is less than or equal 
to zero . 

Self-explanatory . 

The maximum record size of the 
data record exceeded 6800 words . 


The MSS DATAPE must be in 
Universal or LARSYS II/III 
format . 
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Mas sago 

£. ONLY ONE RECORD OR LESS 

% 

PER CHANNEL ACCEPTABLE 
AT THIS TIME. 

g. NO. OP RECORDS PER DATA 
SET = XXXXX, MUST BE 
LESS THAN OR EQUAL TO IS . 

h. NO. OF BITS/PIXEL « XXXXX. 
ONLY 8 BITS ACCEPTABLE AT 
THIS TIME. 


i. DATA ORDER INDICATOR 
XXXXX. DATA MUST BE 
ORDERED BY PIXEL. 


1.17.26 SUBROUTINE WRTHED 
• Message 


Explanation 

All of tho samplos of ore ehan- 
nel must be contained within one 
record . 

One data set cannot contain more 
than 15 records . 

According to the header record/ 
the samples on the MSS DATAPE do 
not equal 8 bits. It is assumed 
that the header record is in 
error, and execution continues . 

Information from header record 
indicates data are not ordered 
properly. All radiance values 
in channel 1 must be given first, 
followed by the radiance values 
in channel 2, and so on for each 
scan line . 


Explanation 


NUMBER OF SAMPLES WAS RESET 
TO 2998. 


Number of samples per line 
cannot be more than 2998 . 
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APPENDIX K 


LACIE-FORMATTED DOT FILE FORMAT 


APPENDIX X 

LAC IE- FORMATTED DOT FILE FORMAT 


The LACIE-foirmatted dot file card images appear as follows: 


Columns 


Parameter 


1-3 

4 

5 

6-7 

8-9 


DOT 

Blank 

HI 

I2I 

Blank 

Category name 
(left justified) 


10 Blank 

11-80 / 1^2 ' ' ' ' '*^N 


Description 
The three letters DOT 

Dot type 


(The EOD-LARSYS allows 
two-cnarau ter category names. 

If a one-character name is used, 
it should appear in column 8) . 


Dot grid numbers (integers) 
separated by blanks 


The LACIE dot grid numbers correspond to sample and 1 ine numbers 
as follows : 


Dot grid number Sample Line 

1 10 10 

2 20 10 

• 

19 190 10 

20 10 20 

« 

« 

39 10 30 

209 190 110 


K-1 


See figure K-1 . 

There its vvo continuation character from one card to the next; 
i.e., each card must have DOT in columns 1 through 3. 

Limitec’ provisions have been made for specifying off-grid dots. 
The do'., number 

LI X 100000000 + SI X 10000 + LACIE number 

corresponds to the LACIE grid position offset by LI lines up and 
SI samples to the right (increasing sample numbers). This method 
of encoding does not correspond to the latest method used in 
LACIE operations and a reconciliation may be made in the future. 

This format is used for EOD-LARSYS files GTUNIT, AIUNIT, and 
PPUNIT. 
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